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SCOPE 

This development effort provides the following new features and 

enhancements to KRONOS tape processing capabilities* 

1* The HMTC/bSX tape sub-system is supported. 

5. The overall reliability and error recoverability of tape 
processing will be improved over that currently available 
by use of new techniques using the CDC tape error recovery 
standard as a guide. 

3. Support of ANSI standard tape labels will be provided. 

M. It will be possible to read a wider range of tape formats 
in a greater number of ways than is now possible in KRONOS 
2 . 0 . 

S. Increased interchange capabilities with SCOPE 3.M. 
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KRONOS 2.0 Batch User's Reference Manual 
KRONOS 2-0 Operator's Guide 
KRONOS 2.0 User's Instant 

ANSI”STD X3.27 - llbT Magnetic Tape Labels 
CDC-STD l.a7.002 Magnetic Tape Labels 

CDC-STD l.a7.00^ Magnetic Tape Error Detection and Recovery 
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* 

3.0 DESCRIPTION 

3.1 The following are the special considerations a user must make in 
order to have access to magnetic tapes in KRONOS 5.1. 

3.1.1 All jobs must specify the maximum number of tapes that will be 
in use concurrently. 

3.1.1.1 A Job specifies the maximum concurrent tapes via the RESOURC 
control card -Csee Appendix E>. 

3.1.1.5 A Job may alter the maximum number of concurrent tapes in 
the following two ways: 

3.1. 1 . 5.1 The RESOURC control card may be used to reduce the number 
of concurrent tapes {refer also to Section 3.1.1.Ml. 

3 .1.1. 5 .5 If tapes are already assignedi the RESOURC control card 
may be used to increase the number of concurrent tapes t 
but if the request cannot be satisfied! the Job will be 
aborted. 
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3.1.1.3 In all of the above cases these definitions of maximum tapes 
in use must be within or equal to the maximum number of tapes 
specified in the user's validation limit. -CSee KRONOS E.Q 
Operating Guidei page fl-S.} 

3.1.1.M Any time that a return -Csee Batch User's Reference flanuali 
Chapter 7}i is done on a tape the number of required 7/1 
track tapes for the job is decremented by one. 
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3c2 Control Cards 

I There are six control cards which are explicitly involved with 

requestingT assigning! and processing of tapes. These are the 
I ASSIGN-. BLANK-, LABEL-, LISTLB-. REtJUEST-, and VSN control cards- 

3.2.1 ASSIGN Card 

The format of the ASSIGN card is as follows: 

ASSIGN-Cdd-.Ifn-.pj^-.Pg-,...-,p^> 

dd = device description which may either be the device type 
in display code or the EST ordinal for the desired 
device. 

where Ifn = file name 

Pt - p = parameters -Csee parameter description in Section 
3.2.4J. 

The ASSIGN card should only be used in the case of tape files 
which are unlabeled and which have not had a Volume Serial Number 
declared by the operator at the time of mounting -Csee Section 
3-2-5 for further detail on this method of assigning tapes}. 

3.2.2 LABEL Card 

The LABEL card should be used for all labeled tapes- This 
control card will cause automatic assignment of tapes to take 
place as well as reading or writing of labels. The general 
format of the LABEL card is: 

LA BEL-Clfn-.pj^-,pg-,. . .-ip^} 
where 

Ifn = file name 

Pj^ - p^ = parameters -Csee parameter description in Section 

3.2.43-. 


AA 3777 


PRINTED IN USA 



CONTROL DATA CORPORATION 

____DIVISION 

DOCUMENT CLASS_£55_ PAGE NO.—I_b_ 

PRODUCT NAME_ KRON OS g . 1 _ 

PRODUCT MODEL NO. C0fi6»g.l _MACHINE LOOO/OC CYBER 7gT7 3T7M 

3.5.3 RE(3UEST Card 

The RE(3UEST card can be used for all types of tape files. If 
the Volume Serial Number is present or has been previously 
specified by a VSN card {see Section 3.5 .S>t then assignment 
will be made automatically. The general format of the REQUEST 
card is: 

RE(2UEST{lfmp^TPgT •. np^J 

where: 

Ifn = file name 

Pn ~ Pr, ~ parameters {see parameter description in Section 
3.5.M}. 

3.5.4 A^SIGNn LABELn and RE(3UEST Control Card Parameters 

The following parameters or keywords/options can appear order 
independent on the indicated control cards. Where two keywords 
express the same option i the first is the KRONOS definition and 
the second is also accepted for SCOPE compatibility. 
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parameter/ 

KEYWORD 

OPTION 

DEFAULT 

VALID ON 
ASSICN-CA} 
LABELCLl 
RE(2UESTCR} 

DESCRIPTION 

LO 


Installation 
Default Used i 

A-.R 

BOO BPI Tape Density 
{Implies 7 track! 

HI : 

1 




HY 


Installation 
Default Used 

A-.R 

flOO BPI Tape Density 
{Implies 7 track! 

HD 


Installation 
Default Used 

AiR 

flOO CPI Tape Density 
{Implies T track! 

PE 


Installation 
Default Used 

A-vR 

IbOO CPI Tape Density 
{Implies T track! 

D='nn 

LOiHInHY-, 

HDiPE 

Installation 
Default Used 

AiL-iR 

i 

Same as above parameters 

D=nnnn 

SDO-iSSbi 
dOOilbOO I 

Installation 
Default Used 

AtLiR 

Same as above parameters 

FC=nni'>nr3n 

i 

nnnnnn= j 
numeric 
FRAME 
COUNT 

See Format 
Option 
Appendix D 

AiL-iR 

Defines the maximum size 
block that maybe read or 
written. See formats in 
Appendix D* 

C=nnnnnn 

nnnnnn= 
numeric t 
BIT CHAR¬ 
ACTER 
COUNT 

See Format 
Option 
Appendix D 

AiR 

Defines the maximum size 
block that maybe read or 
written. See formats in 
Appendix D. 

CV=ni» 

N=nn 

US-,AS 


A-.L-.R 

USASI{ASCII! conversion 
for T track tape 

EB 


AiLiR 

EBCDIC conversion for 

T track tape 

MT/NT 


MT 

A-.L-.R 

Seven/Nine Track 

P0=Cj-iCg-. 

• • • 

n 


Absent 

A-.L-.R 

Defaults abort job on 
RPE/UPE {unless EP set! 

A 

1 ' ' 

A-iLiR 

Automatic abort on RPE/ 
UPE {even if EP set! 

N 

I 

iA-iL-iR 

! 

No abort on RPE/UPE 
{with/without EP! 

R 


A-,L-.R 

Enforce ring out 

bJ 


AiL-iR 

Enforce ring in 

U 

_1 


AiLiR 

Inhibit unload at end of 
usage 
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PAKAfltTER/ 

KEYWORD 

OPTION 

DEFAULT 

VALID ON 
ASSIGN -CA} 
LABEL-CL> 
RE(2UEST{R> 

DESCRIPTION 


E 


A-.L-.R 

Error Inhibit* Negates 
all processing of errors 
when possible. The call¬ 
ing routine will not re¬ 
turn error information 
back. 

I 


AiLtR 

Ignore block in progress 
when EOT sensed 

P 


AiLiR 

Accept block in progress 
when EOT sensed 

S 

_1 


A-.L-.R 

Stop at tape mark after 
EOT sensed -Cunlabeledl 
or at tape mark + EOFl 
or EOVl {labeled} 
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PARAMETER/ 

KEYWORD 

OPTION 

DEFAULT 

VALID ON 
ASSIGNIA} 
LABELIL} 
REflUESTIR} 

DESCRIPTION 

|F-n 

I 

X 

B 

E 

S 

L 

SI 

F 

I {LABEL} 

AnLnR 

See Appendix D on tape 
formats. 

X {AtR unless 
VSN parameter 
is present 
then I mode.} 

NS=nn 

■ 

nn = 

numeric 

frames 


AnLiR 

Noise size in frames 

LEj=nn 

KU 

KU unless VSN 
parameter on 
control card 
then default 
KL. 

AnLiR 

KRONOS Unlabeled 

:<L 

KU unless VSN 
parameter on 
control card 
then default 
KL. 

AtL-iR 

KRONOS Labeled 

1 

1 

NL 

KU unless VSN 
parameter on 
control card j 
then default 
KL. 

AiLnR 

! 

Non-Standard Labeled 
{Skips over labels based 
on tape marks. No pro¬ 
cessing of label data 
performed. End of reel 
treated as if unlabeled.} 

VSN=aaaaaa 

I Lo b 
characters 

See Label 

defaults 

Section 

3.S.4.E 

AiLnR 

Volume Serial Number 

CK 

i 


AtLiR 

Will cause ID code of TbB 
to be set on file to indi¬ 
cate checkpoint file where 
data is to be written at 
EOI 
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PARAMETER/ 

KEYWORD 

OPTION 

DEFAULT 

VALID ON 
ASSIGN-CA} 
LABELILl 
RE(2UEST{R} 

DESCRIPTION 

CB 

' ' ' ■. 


A-.L-.R 

Checkpoint file to be 
written at beginning of 
information. Sets ID 
code to 7SB. 

FI=aaaa 

• • • 0 

L=aaaa 

• • • 0 

1 to 17 
characters 

See Label 

defaults 

Section 

3 • S • M • 2 

L 

File Identifier 

A=n 

Icharacter 

See Label 

defaults 

Section 

3.S.M.2 

L 

File Accessibility see 
Section 3.2.5 

SI=aaaaaa 

I1~aaaaaa 

1 to L 
characters 

See Label 

defaults 

Section 

3.S.M.a 

L 

Set Identifier for multi¬ 
file set 

SN=nnnr 
V=nnnn 

M digits 

See Label . 

defaults 

Section 

3.S.M.2 

L 

File Section Number 

(3N=nnnn 

P=nnnn 

M digits 

See Label 

defaults 

Section 

3.S.M.2 

L 

File Sequence Number 

C=nnnn 

M digits 

i 

See Label 
defaults 
Section ■ 

3.S.M.2 

L 

Generation Number 

E=nn 

2 digits 

See Label 
defaults 
Section 
^3.S.^.2 

L 

Generation Version Number 

CR=yyddcl 

C=yyddd 

Julian 

Date 

See Label 

defaults 

Section 

3.5.M.2 

L 

Creation Date 

RT=yyydd 

Julian 

Date 

i 

1 : 

(See Label 

defaults 

Section 

3.5.M.2 

L 

Reten^tion Date 
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PARAMETER/ 

KEYlilORP 

OPTION 

DEFAULT 

VALID ON 
ASSIGNIA} 
LABEL-CL> 
RECUEST-CR} 

DESCRIPTION 

T=nnn 

3 digits 

See Label 
defaults 
Section 
3.S.M.S 

L 

Retention Cycle 

R/lil 


R 

L 

READ/URITE Label - On 
read data is read and 
compared. If compare 
fails job is aborted. 
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3.e.S BLANK Card 


The BLANK card is used to initially label a magnetic tape with 
a Volume Header Label -CVOLIIt a First File Header Label -CHDRlli 
and a First End-of-File Label -CEOFl}. The labels are written 
on the tape in the structure shown below: 



VOLl 

HDRl 


>|c 

EOFl 




_ 










L 


I I 

Load Point E-Tape Narks E-Tape Narks 


If a tape had been BLANK labeled with the Volume Accessibility 
{Accessibility field in the VOLl labeli see Section 3.S.M.E-13- 
blank t the tape may be relabeled using the BLANK card or it 
may be written as unlabeled• This is the only case where the 
Volume Header Label {V0L1> may be rewritten- 

If a tape had been BLANK labeled under KRONOS E-1 {determined 
by contents of System Code in HDRll with the File Accessibility 
{Accessibility field in the HDRl labeli see Section 3-S.M-E-Eli 
field non blank the tape may be accessed by a user other than 
the owner provided the A parameter is used on the ASSIGN-■ LABELi 
or REQUEST card {see Section 3-E-M> and matches- If the 
accessibility character is specified as an "A" at BLANK time-i 
then only the owner may access the tape- The contents of the 
labels are their respective default values except for those 
fields for which there are corresponding parameters on the 
BLANK card- These are Volume Serial Number-i Accessibility-i 
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Owner Identification! and Label Standard Level in the VOLl 
label and Accessibility in the HBRl label {see Section 3.S.M.2 
and Appendix B>. 


Fornat of BLANK Card: 

BLAN KCVSN =vsn n VA=v •.0UNER=f amily/usernum-i LSL=1 -iFA =f ! D^dn (1T/N Tl 

vsn l-b character Volume Serial Number. If characters 

other than alphanumerics are usedn the VSN must be 
written as a literal {see Section 3.2.fl>. 

V 1 character Volume Accessibility {Accessibility in 

V0L1>. 

family* 1-7 character Family Name. 

usernum* 1-7 character User Number. 

1 1 character Label Standard Level. 

f 1 character File Accessibility {Accessibility in 

HPRl}. 

d Density {see Section 3.2.Ml. 

MT/NT Tape track type {see Section 3.2.4}. 

* If family or usernum are not specified and a user is making 
the BLANK calli the values for family and usernum are taken 
from the control point area. 
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3.2.b LISTLB Card 

The LISTLB control card causes a standard labeled tape to be 
read and the contents of the labels on the tape written on a 
specified file. 


Format of LISTLB Card: 

LISTLBCplip21 •.•T pn1 

where parameter pi may be any of the following: 


VSN=vsn 

I>=d 

SI=aaaaaa 

(3N=nnnn 

10 = 


L= 


Volume Serial Number -Csee Section 3.2.Ml 
Density -Csee Section 3.2. 

Set identification -Csee Section 3.2. Ml 
Sequence number {applicable only if SI present} 
List options 

A all labels 

R or omitted - required labels {VOLl-i HDRIt 
EOF li EOVl} 

0 optional labels 

Output file name 


The VSN= parameter must be specified. Default values are: 
D = installation default 
LO = R 
L = OUTPUT 
SI = none 
(2N = none 
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I 3.5.7 VSN Card 

The VSN card associates one or more reels of tape by the Volume 
Serial Number of the reel with a file name appearing later in 
the control card record. A VSN card can contain declarations 
for more than one file name and Volume Serial Number. 


VSN cards may be placed anywhere in the control card record as 
long as they precede the REQUEST or LABEL card for the file 
named. If a logical file name is to be re-used during a jobi 
the first file must be released by a CLOSE/UNLOAD {see KRONOS 
5.0 Batch User’s Reference Manuali page S-B'l} or RETURN {see 
KRONOS 5.0 Batch User’s Reference Manuali page S-3S} control 
card before a VSN is given for the second file. 


Format of VSN card: 

VSN{lfn=vsnT...> 

Ifn For a single filei the 1-7 alphanumeric character 
logical file name 


vsn 1-t character Volume Serial Number. If characters 
other than letters and numbers are usedi the VSN 
must be written as a literal {see Section 3.3.*!}. 

If any of several duplicate reels will suffice t 
equals signs should separate identifiers as in: 
FILE=153M=153S. 

If the file extends to more than one reeli slashes 
should separate the identifiers for all reels re¬ 
quired. KRONOS will assign the reels in the order 
indicated within this parameter. For examplei 
FILE5=53/5M/5S. 

Up to SS VSN’s may be defined for a file. 
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If the VSN is absenti 0i or SCRATCHt any available scratch tape 
may be assigned to the logical file named* 

3.5^6 Continuation Cards 

Any of the above four control statements! ASSIGN i REQUESTt 
LABELn VSN if necessary may continue over more than one 50- 
column card. Continuation is assumed if no termination char¬ 
acter has been encountered prior to reaching the end of the 
current card. All continuation cards must contain a blank in 
column 1. It should be noted that it will only be possible 
to handle continuation cards from terminals if they are con¬ 
tained within procedure files. 

I 3.3.T Literals 

Any of the above control statements may contain a literal so as 
to allow parameters that contain non-alphanumerics -Ca literal 
is a character string delimited by dollar signs}. Any parameter 
field that requires characters other than letters! numbers or 
asterisks must be written as a literal. Blanks within the 
delimiters are retained. If the literal is to contain ”$"! two 
consecutive dollar signs must be written. The literal $A B$$m$ 
is interpreted as "A B$m”. Uhere continuation cards are in¬ 
volved! any literal must not continue from one card to another. 
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3.2«1D Parameter Processing 

If more than one control card parameter of a given type occursi 
the last one encountered in a left to right scan is used. 


If both ring enforcement options fR and IJ> or more than one 
of the end-of-tape options -CIt P or SJ are specified for the 
processing option parameter P0i an argument error will occur. 
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3.3 dacro Interface 

All references to words within a FET are octal numbers. The 
first word of the FET containing the file name is considered 
word 0• 


303.1 LABEL Macro 

The format of the LABEL macro is as follows: 

LABEL IfmN 
where: 

Ifn = file name 

N = do not process labels if present 
The LABEL macro may be used to reference all tapesi both 
labeled and unlabeled. Label processing will be performed 
■Csee Section 3.3.5} by means of an OPEN/ALTER or OPEN/URITE 
depending on the setting of bit 5^*^ in FET+lOB- If ”N" is 
present! no label processing will be performed. The FET 
format for the LABEL macro is described in Section 3.3.M. 

3.3.2 POSMF Macro 

The format of the POSMF macro is as follows: 

POSMF mfnnR 
where: 

mfn = multi-file set name 
R = recall 

The POSMF macro positions standard labeled multi-file magnetic 
tape sets to a member of the set. The named multi-file set is 
positioned to the specified file and an OPEN with rewind is 
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performed. The file to be opened is determined by the contents 
of the HDRl label for the file. The contents of the HDRl label 
may be found in words IIB - ISB of the FET -Csee Section 3.3.m 
in standard label processing mode or in the user label buffer 
in extended label processing mode. The position of the file 
within the multi-file set {Set Identification field in the 
HDRl label {see Section 3.5. *4.5. S» is determined by the File 
Sequence Number in the HDRl label. If the File Sequence Number 
is not specified-! the set position is determined by the File 
Identifier. If the File Identifier is also not specified-i the 
set will be positioned to the beginning of the next file- The 
delivery of the contents of the HDRl label to the user is as 
defined for "open for read" in standard and extended label 
processing {see Section 3.3.5}. If the File Sequence Number 
is TITIt the OPEN of the file is as defined for "open for write" 
and the set will be positioned after the last member of the set. 

The tape executive will alter the File Sequence Number to be 
equal to the File Sequence Number of the last member of the 
set plus 1. The FET format for the POSNF macro is as described 
in Section 3.3.M. 

3.3.3 REQUEST Macro 

The format of the REQUEST macro is unchanged from KRONOS S-O 
{see Batch User's Reference Manuali page 7-57}- 
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3.3.M FET format for macros 

The FET format for tape related macros is as specified below. 
Compatibility to SCOPE product sets will be provided through 
the special SCOPE interface routine -CSFPl. 
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FET + IQB thru FET + ISB 
of Tape Files at Request Time 


Location Bit Field Meaning 


FET+lOB 

SO 

If set-i 

FET+lOB 

sa 

If seti 

FET+lOB 

S7 

If set -1 

FET+lOB 

Sb 

If set-i 
default 


LABEL is to be written* 

defines tape as labeled. 

defines non-standard labels. 

tape request for nine track where 
is seven track. 


FET+lOB SS-S^ 


Flag bits not currently in use. 


FET+lOB S3-S1 Density: 

0 = installation default 

1 = SSb BPI 

2 = 200 BPI 

3 = aOO BPI 
M = IbOD CPI 

FET+lOB SO-Ma Conversion mode: 

0 = installation default 

1 = ASCII/USASII conversion for T tracks 

2 = EBCDIC conversion for T tracks 


FET+lOB M7-3b 


Processing Options: 

bit set = ignore block in progress 
when EOT sensed 

bit Mb set = accept block in progress 
when EOT sensed 


NOTE: Only one of bits M7 or Mb may be 

set. If neither is seti stop at 
tape mark after EOT sensed -Cun- 
labeled} or at tape mark + EOFl 
or EOVl after EOT sensed {labeled} 


bit 

m 

set 

bit 

MO 

set 

bit 

30 

set 

bit 

3a 

set 

bit 

37 

set 

bit 

3b 

set 


inhibit unload at end of 
usage 

enforce ring in 

enforce ring out 

inhibit error processing 

no abort on RPE/liIPE 

abort on RPE/UPE even if EP 

set 
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Location 

Bit Field 

Meaning 




NOTE: 

If neither 37i or 3tj is seti 

abort on RPE/UPE unless EP set 

FET+IDB 

3S-30 

Format: 




□ = I 

1 = SI 

2 = X 




3 = S or L 



M = E 

S = B 
b = F 


FET+IGB 

eG-2M 

Noise size 

in frames* 

FET+lOB 

23-DO 

Block size 

in frames* 
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Location Bit 

Field Meaning 

f 




FET+llB 

S'i-HM 

b display code characters 
Number 

= Volume Serial 

FET+llB 

23-ia 

1 display code character = 

File Accessibility 

FET+llB 

17-lS 

Unused {3 bits! 


FET+llB 

m-Q 

IS bit binary File Section 

Number 

FET+i2B 

S'l-O 

First 10 display code characters of File 
Identifier 

FET+13B 

s'l-ia 

Last 7 display code characters of File 
Identifier 

FET+13B 

17-lS 

Unused {3 bits! 


FET+13B 

m-Q 

IS bit binary File Sequence Number 

FET+mB 

S'l-BM 

b display code characters 

= Set Identifier 

FET+IMB 

23-15 

T bit binary Generation Version Number 

FET+HB 

m-0 

IS bit binary Generation Number 

FET+ISB 

5^-30 

S display code characters 
Expiration Date 

for Julian 

FET+ISB 

2=I-D 

S display code characters 
Creation Date 

for Julian 
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3»3»S LABEL Processing for OPEN/CLOSE Requests 

There are two modes of label processing: standard and extended^ 

m 

standard label processing is indicated by the XL bit {bit 2 } 

in FET+1 being set off {XL=0> in which case any information for 
label processing is contained in FET+llB-lSB of FET’s whose 
length is at least IbB words {see Section 3*3.M>. Extended 
label processing is indicated by the XL bit being set on {XL=1} 
in which case a user label buffer pointed to by FET+llB is used 
to hold all labels to be processed. 


Throughout this section the terms "open for read" will mean an 
open using CIO codes IDDBt IEDBt IMOBt ILOBi BOOB or 3^0B•l 
"open for write" will mean an open using CIO codes 10MB or 
IMMDi and "closed" will mean closed using CIO codes 130Bi ISOBn 
170B or 17MB. {See Appendix ]> for handling of CLOSER - close 
reel. > 


3.3.S.1 Standard Label Processing 

In standard label processing mode onlyn the required ANSI 
format labels are processed. These are the Volume Header 
Label {VOLlJn the File Header Label {HDRlli and End-of-File 
Label {EOFlJi and the End-of-Volume Label {EOVIJ. Optional 
user labels and optional operating system labels not generated 
by KRONOS 2.1 will be ignored. When a magnetic tape file is 
openedi the tape executive guarantees that no processing 
will occur unless the Volume Serial Number contained in the 
VOLl label agrees with that requested by the user. If the 
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file is opened for readi the information contained within 
the HDRl label is delivered to the user's file buffer if 
sufficient space permits when the HDRl label has been success¬ 
fully verified. If the user's FET is less than IbB words in 
length-, any label will be accepted without verification- If 
the FET is at least IbB words longi the information contained 
in the HDRl label is compared with the information contained 
in words IIB-ISB of the FET- Should any mandatory field 
disagree-, an informative diagnostic will be issued and pro¬ 
cessing will continue as if an unrecoverable parity error 
had occurred. -Ci-e. - The error options will determine job 
status.} If the file is opened for write-, the HDRl label is 
formatted within the tape executive. If the FET is at least 
IbB words long -1 the information contained in words IIB-ISB 
of the FET is used in formatting the HDRl label- If the 
FET is less than ItB words in length-, default values are 
used in formatting the HDRl label -Csee Section 3.S.M.5.S}- 

Uhen a magnetic tape file is closed-, if the last operation 
was a write-, the tape executive writes a tape mark-, the EOFl 
label or the EOVl label. The optional contents of the EOFl 
and EOVl trailer labels are taken from the optional fields 
of the HDRl label -Csee Appendix D for more details}. 
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3.3.S.2 Extended Label Processing 

In extended label processing! all labels read or written by 


the system are found in the user label buffer. The user 


label buffer is defined by word FET+llB as follows: 


ST 35 17 0 



Length of 

FUA of 


Label Buffer 

.. _ _i 

Label Buffer 


FET+llB 


Uithin the label buffer! each label that appears is in 
display code with the same format it has on the tape {see 
Appendix Bl and is preceeded by a status word of the format: 


5 ^ 


11 


□ 


Characters 
in label 


Only bits 0-11 should be set by the user to show the number 
of characters in the label. The last label in the buffer 
must be followed by a status word of all zeros. 


Uhen a magnetic tape file is opened! the tape executive 
guarantees that no processing will occur unless the Volume 
Serial Number {VSN} contained in the VOLl label agrees with 
that requested by the user. If the file is opened for read! 
the user label buffer is searched for a HDRl label. If 
found! the HDRl tape label is compared with the information 
contained in the user label buffer. If any discrepancies 
occur! an informative diagnostic is issued and processing 
continues as defined for standard label processing. If no 
HDRl label is found in the user label buffer! the HDRl tape 
label is accepted without verification. After the open is 
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issued 1 all labels -Cboth required and optional} are delivered 
to the user label buffer beginning with VOLl- The respon¬ 
sibility for the verification of all labels other than VOLl 
and HDRl resides with the user. 

If the file is opened for write or closed t any user labels 
to be written must be present in the user label buffer order 
independent. The user mayi but need noti specify the required 
labels. Required labels will be generated using default 
values if not specified. User specified VOLl labels are 
ignored^ HDRl labels in the label buffer will be used if 
the file is being opened for write. EOFl and EOVl present 
in the label buffer will be used if the file is being closed. 

Extended label processing will be implemented as time and 
funding permits. 
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3.M Operator Interface 

3.M.1 On all tape requests where a VSN is absent or has not previously 
been specified by a VSN cardn the operator assignment will be 
handled as in KRONOS 5-0 -Csee KRONOS 2-0 Operator's Guide-, 
page 3-1D3-. This is not the recommended procedure in KRONOS 
2»li but it is retained for compatibility. 

However 1 if the tape request had specified an equipment number 
{e.g.T ASSIGN card}-, a pseudo-VSN will be given to the tape 
mounted on the specified equipment and the assignment is handled 
as if the VSN had been specified -Csee Section S.M.l.l}. 

3.^.1.1 Uhenever a VSN is known for the tape-, tape assignment occurs 
automatically when the tape becomes available providing the 
assignment of the tape does not create a deadlock situation 
■Csee Appendix E}. 

3.M.1.2 If a tape is a standard labeled tape-, then the availability 
of the tape is determined automatically by the system by 
checking the VOLl label at the time the tape is mounted. 

If a tape is not a standard labeled tape or after the system 
has determined the Volume Serial Number on a standard labeled 
tape-, it is possible for an operator to enter a Volume Serial 
Number for a given unit -Csee Section 3.^.l3.1}. 
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1.M.5 The operator will be notified via the tape display -Csee Section 
3.M.S and Appendix O to mount a particular tape if it is the 
next reel in a multi-reel set or has been dismounted during 
the assignment sequence. 
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3»M«3 The EST entry format to specify tapes is as follows: 

E(3ee = nT-n-iavieqTUUichaichbichcichd. 
where: 

ee = Starting EST ordinal. 

n = Number of units. "n" EST entries will actually be 
generated consecutively starting at ee. 

av = ON or OFF. This will only be meaningful in regards 
to ASSIGN cards. 

eq = Controller equipment number. 

uu = Starting unit number. The actual units in use must 
start with unit number uu and there must be n units 
available with consecutive unit numbers. 

cha-i chbi chci chd = 1 to M optional channels. 

3.M.M In order to obtain optimum tape performance and throughput-i the 
following restrictions are placed on tape configurations: 

3.M.M.1 Uhen more than one channel access is available to some tapesi 
the configuration for all units that may be accessed by 
multiple channels must be the same. In additioni all other 
tapes to be supported must be on one of the multiple channels. 
An example of this is as follows: 

Given: 

3S5fl-3 and a 3S5fi. If the 3SSfl-3 is accessed thru 
channels 7 and 13 t then the 3SEfi will have to be on 
either channel 7 or 13. Also if another 3S5fl-3 was added 
to the above it would have to be on channels 7 and 13 
also. 
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3.M.M-5 Unit numbers on tape units must not be switched after tape 

executive initialization* Otherwise! for example-j unit types 
such as 7 and T track will get confused- 

3«M.£ DS/) Displays 

A tape display will be provided in order to provide the operator 
with an easy way to determine tape availability! drive status! 
Volume Serial Number of tape mounted! job assigned tO! etc- A 
second display will be provided in order to provide the operator 
with a list of Volume Serial Numbers and removable disk Packnames 
which active jobs will need to have mounted so that they may 
eventually complete. See Appendix C for the description of 
these displays- 

3.M.b Operator Commands 

3.M.ia-l VSN Command 

The VSN command allows the operator to specify a Volume Serial 
Number for a mounted unlabeled tape so that it may be assigned 
and referenced from a job automatically. The format of the 
command is as follows: 

VSN!nn!aaaaaa. 
where: 

nn = unit number 

aaaaaa = Volume Serial Number. 

This allows automatic assignment for non-labeled tapes. 
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B.M.b.B DOWN Command 

The DOUN command allows the operator to logically remove a 
tape or disk drive-Cs} from the operating environment while 
retaining all tables associated with the drive. The format 
of the command is: 

DOUNleq. 
where: 

eq is the EST ordinal of the equipment* 

UP Command 

The UP command allows the operator to logically restore a 
tape or disk driveCs} to the operating environment. The 
format of the command is: 

UPieq. 

where: 

eq is the EST ordinal of the equipment. 

3.M.b.M UNLOAD Command 

The UNLOAD command causes a tape or disk drive to be temporarily 
unavailable while the operator dismounts the tape or disk pack. 

For removable packsn no new users will be allowed to access the 
pack. Current users may use the pack to complete their jobs* 

The format of the command is: 

UN LOAD neq. 
where: 

eq is the EST ordinal of the equipment. 
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I 3.M.b»S n* MAGNET. Command 

This command allows the operator to initiate the KRONOS tape 
executive {MAGNET! at control point n* It is necessary for 
MAGNET to be active in order for tape processing to take 
place under KRONOS 5*1« 

I 3.M«b.b Enable/Disable Commands 

Two commands are provided for the operator to be able to 
control whether MAGNET is initiated or not on an AUTO or 
MAINTENANCE PSD command {see Operator's Guide-i Chapter 3}. 

The format of these commands are as follows: 

ENABLE, MAGNET. 

DISABLE,MAGNET. 

The entering of MAGNET in an IPRDECK or during deadstart, 
while SET is processing IPRDECK, will toggle the status of 
initialization for MAGNET. 
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3»S Tape Formats 


See Appendix P. 


3.S.B 


This section contains no information* 


3.5*3 This section contains no information 
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3.S.M Label Parameters and Fields 


B.S.M.l ANSI Standard Label Fields 

The four required ANSI labels are as follows. Tape 

marks separating items are completely system controlled. 

VOLl Must be the first label on a labeled tape. Each 

volume in a volume set must be identified as VOLli 
a field in the following HDRl label gives an actual 
reel number. 

HDRl Required label before each file or continuation of a 
file on another volume. It is preceded by a VOLl 
label or tape mark. Each file must have a HORl label 
which specifies an actual position number for multi¬ 
file sets. 

EOFl Terminating label for file defined by HORl labeli the 
EOFl label is the KRONOS end-of-information for the 
file. A single tape mark precedes EOFl- A double 
tape mark written after the EOFl label marks the end 
of a multi-file set. 

EOVl Required only if physical end-of-tape reflector is 

encountered before an EOFl is written or if a multi¬ 
file set is continued on another volume. It is pre¬ 
ceded by a single tape mark and followed by a double 
tape mark. 

The structure of KRONOS tapes that results from these required 
labels is shown below. The label identifier and number is 
used to denote the entire flO-character label in these figures. 


Single Reel File: 


Load Point 




-Tape Hark 




End-of-Tafse-Ref lector 


-./ 1 . 



Ky 1 

^ ! VOLl 

m i 1 

HDRl * ; FILE A i * ! EOFl 

» - 1 i. 

% 

i 

.*1 


Double Tape Hark 
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Multi-Reel File: 



VOLl 

HDRl 


FILE A 

]- ^ i ELJ 

* EOVl *1*1 

1 . 

VOLl 1 

HDRl 

file a 

! -C Continued! 

_ A- _ .. .. . 

r."T ' 1" f • i_..j 

* I EOFl i * * 1 

i.1.! , i 


Multi-File Reel: 



VOLl 

HDRl 


FILE A 


_ mi.. 





_.... 


EOFl 



HDRl I* 


FILE B 


* 


.V 

EOFl i* 


I 






Multi-File multi-reels in a volume set are also possible. 
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3.S.M.S Format and Contents of Labels 

The word "optional" is sometimes used in the name or descrip¬ 
tion of fields in this specification* When usedi "optional" 
means that the field mayi but need noti contain the informa¬ 
tion described. If an optional field does not contain the 
designated information! it shall contain spaces. In the 
following descriptions! "n" means any numeric digit! D through 
T. An "a" means any of the characters occupying the center 
four columns of ASCII {American National Standard Code for 
Information Interchange} except position S/IS and those 
positions where there is a provision for alternative graphic 
representation. 

The limitation on "a" characters is intended as a guide to 
provide maximum interchangeability and consistent printing 
especially when international interchange is a possibility. 
Checking for conformity to this limitation is not implied. 

Fields which are not described as "optional" are required 
and will be written as specified. 
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3.£.M-.E»1 Volume Header Label 

Character 

Position Field Name Length 

1~3 1 Label Identifier 3 

4 5 Label Number 1 

5-10 3 Volume Serial Number b 

11 4 Accessibility 1 


ia-31 

5 

Reserved for future 
standardization 


35-37 

Li 

Reserved for future 
standardization 

b 

3a-si 

7 

Owner Identification 

14 

S2-7T 

a 

Reserved for future 
standardization 

Ea 
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> 

> 

y Character 

^ Position Field Name 

6D ^ Label Standard Level 





1 1 means the labels and data Blank 

formats on this volume con¬ 
form to the requirements of 
the ANSI standard. "Space” 
means the labels and data 
formats on this volume re¬ 
quire the agreement of the 
interchange parties. 


T) to O 
70 TO a 

o o n 
o o c 
c c 2 
n n m 
H H z 

2 z 
o > o 
a 2 r 
m m > 


DTK n 
C3 70 70 
03 O 

^ O 
nj 


CP £ 

a m 
C3 z 


-j 

jr 
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3.S.4.2«5 First File Header Label 
Character 

Position Field Name 

1 Label Identifier 
4 5 Label Number 

S“21 3 File Identifier 

25-57 M Set Identification 


56-31 5 File Section Number 


32-35 L File Sequence Number 

1 

2 


Length l^ascription 
3 (lust be HDR 
1 (lust be 1 

17 Any "a" characters agreed 
on between originator and 
recipient. 


b Any ”a" characters to 

identify the set of files 
of which this is one. 

This identification must 
be the same for all files 
of a multi-file set. 


Default 


Blank 


Blank 


M The file section number of 0001 
the first header label of 
each file is 0001. This 
applies to the first or 
only file on a volume and 
to subsequent files on a 
multi-file volume. This 
field is incremented by one 
on each subsequent volume 
of the file. 


M Four "n" characters denoting 0001 
the sequence {that isi 0001i 
0005-1 etc.> of files within 
the volume or set of volumes. 

In all the labels for a 
given file-i this field will 
contain the same number. 


■0 o 

7) •JO o 

o o o 
o o c 
c c z 
o n m 
H n 2 
Z 2 

o > n 
o z r- 
m m > 

I ^ 


m 7^ m 

CD TV JO 

o o n 
o. z 
o 
ru uo 
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Description 


Default 


Four "n” characters denoting GOOl 
the current stage in the 
succession of one file gener¬ 
ation by the next* lilhen a 
file is first createdi its 
generation number is 0001* 

Two "n" characters distin- DO 
guishing successive 
iterations of the same 
generation. The generation 
version number of the first 
attempt to produce a file is 
□0. 

A "space" followed by two Current date 
"n" characters for the yeari 
followed by three "n" char¬ 
acters for the day -COOl to 
3bti} within the year. 

Same format as field T. Current date 

This file is regarded as 
"expired" when today's date 
is equal toi or later thani 
the date given in this 
field. Uhen this condition 
is satisfied-I the remainder 
of this volume may be over¬ 
written. To be effective 
on multi-file volumes there¬ 
fore! the expiration date of 
a file must be less thani or 
equal toi the expiration date 
of all previous files on the 
volume. 


-D TJ o 

;» 5P o 
o o o 
o o c 
c c 3 
o o m 

H H z 
2 Z “• 

o > o 
0 2 1 - 
m m > 

r* I ^ 

CO 


m 7^ m 
CD ^ ^ 

03 o 

03 2: 

^ o 
nj n 
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Character 

Position Field Naine 
SM 11 Accessibility 


SS-bO 15 Block Count 


Length Description Default 

1 An ”a” character which Blank 

indicates any restrictions 
on who may have access to 
the information in this file. 

A "space" means unlimited 
accessi any other character 
means special handlingi in 
a manner agreed between the 
interchange parties. 

b Must be "zeros" 


*0 "O o 
yo o 
o o o 
o o c 
c c 2 
n o m 


H 

2 z 
o > 

O 2 

m m 


z 

o 


z 

H 

o 

1“ 


m 

Z) 

VJ 


bl-73 


13 System Code -CoptionalJ 


13 Thirteen "a" characters KRONOS B.l-nn 

identifying the operating -CUhere nn=EST 

system that recorded this ordinal of 

file. unit written 

on.} 


7M-flD m Reserved for future 

standardization 


7 Must be "spaces" 


2 

> 

O 


m 

CO 

m 

5 

m 

CO 

IT 

□ 

a 

CD 

n 

n 


D 

> 

O 

m 

z 

p 




ri 

-c 

□0 

m 

nj 

-nJ 

LU 


LU 

a 


70 

fO 

< 


o 

< 


o 

z 


-v) 

JZ 
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3.S.M.2»3 First End-of-File Label 


Character 

Position Field Name Length Description Default 

Label Identifier 3 Must be EOF 

Label Number 1 Must be 1 

Same as corresponding SO Same as corresponding fields 

fields in the first {total} in the first file header 
file header label label 

{optional} 

Block Count b Six "n" characters denoting 

the number of data blocks 
{exclusive of labels and 
tape marks} since the pre¬ 
ceding HDR label group 

bl-flO 13Tm Same as corresponding 50 Same as corresponding fields 

fields in the first {total} in the first file header 

file header label label 

{optional} 


1-3 1 

M 5 

S-SH 3-11 

SS-bD 15 




T) 

50 
O 
a 

e __ 

n o m 


^ o 
50 o 
o o 

Q C 
C 3 


2 Z 
O 2 

m m 


3: 

> 

o 

X 

z: 

m 

cn 

m 

2 

m 

!r 

a 

a 

a 

\ 

ri 

r\ 

n 

-< 

05 

m 

50 

-j 

nj 

ui 


2 

H 

n 

r- 

> 

CO 

</> 


m 

|50 


UJ 


50 

fD 

< 

V 


•D 

> 

o 

m 


O fC 


2 

< 

fc 

a 

z 
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3*5. >4.5* M First EncJ-of-Volume Label 


Character 

Position Field Name Length d escription default 

1“3 1 Label Identifier 3 Must be EOV 

4 5 Label Number 1 dust be 1 

S-S4 3-11 Same as corresponding SO Same as corresponding fields 

fields in the first {total! in the first file header 

file header label label 

{optional} 

SS-bO 15 Block Count b Six "n" characters denoting 

the number of data blocks 
{exclusive of labels and 
tape marks} since the pre¬ 
ceding HdR label group 

bl-SD I3im Same as corresponding 50 Same as corresponding fields 

fields in the first {total} in the first file header 

file header label label 

{optional} 


"0 T) o 
yo TO o 
o o n 
o o c 
c c 2 
n n m 
-I z 

2 z “• 
o > n 
o 2 r 
m m > 
tn 
in 

2 
O 


n 

(/O 


2 

> 

n 

X 

2 

m 

</j 

m 

5 

m 

CO 

cr 

o 

o 

a 

N* 

O 

-c 

CD 

m 

70 

ru 

j 

UJ 


“Q 

> 

O 

m 

2 

O 


UJ 

nj 


70 

fO 

< 


o 

< 

sc 

o 
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__ , -DIVISION 

DOCUMENT CLASS—IRS_^_ PAGE Kin I 33 Rev /r’ | 

PRODUCT NAME_ KRONOS g.l _ 

PRODUCT MODEL NO. EDafl*5»l _MACHINE CYBER 7g-»?3 7M 


3«b Deadstart 

KRONOS will be able to deadstart from a bOMi ti07i bS7 or bST tape 
unit* 


3«7 Other 
3*7«Ji Limitations 

An ability to handle PRU's greater than SSbO bytes in length 
will be provided for read on all drives except possibly the 
bS'l-3 and bST-M at IbOO BPI. The upper limit on this for all 
drives will be EQiOOQ bytes* A free channel besides the tape 
channel will be required for this capability* 

3*7*2 Reliability 

3*7*2*1 Controlled Backspace will be used in error recovery* 

3*7*2*2 Programmable Clip will be considered based on available time-i 
funding! and hardware* Implementation of this feature does 
not change these external specifications. 
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____DIVISION 

DOCUMENT CLASS__ PAGE NO.l_ Ml 

PRODUCT NAME _ KRONOS Syl _ 

PRODUCT MODEL Kin EOafi^a.l _MACHINE CYBER 75i73 -.7H 

M.n DEFINITIONS 
BLOCK 

A group of contiguous characters recorded on or read from magnetic 
tape as a unit* 

FILE 

A collection of information-i consisting of the records pertaining 
to a general subject* The absence of information may result in 
the creation of a file {delimited by adjacent tape marks! without 
information * 

FILE SET 

A collection of one or more related files recorded on one or more 
volumes. A file set may consist of! 

One file recorded on a single volume* 

(lore than one file recorded on a single volume* 

One file recorded on more than one volume* 

More than one file recorded on more than one volume* 

LABEL 

A block at the beginning or end of a volume or a filei which 
serves to identify or delimit t or both identify and delimiti that 
volume or file* 

LABEL GROUP 

A collection of contiguous labels pertaining to a file that precede 
or follow that file or part of that file on one volume* The 
Volume Header Label or labels together with the File Header Label 
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_ ___DIVISION 

DOCUMENT CLASS_M^_ PAGE md ^ 1 

PRODUCT NAME_ KRONOS g.l __ 

PRODUCT MODEL NO __MACHINE bOOD/CDC CYBER 

or labels that follow them are considered to be the first label 
group on the volume. 

RECORD 

A collection of related items of datai which for operating system 
logic purposes is treated as a unit of information- 

TAPE MARK 

A special configuration recorded on magnetic tape-i essentially 
indicating the boundary between files and labelsi and also between 
certain label groups. The tape mark configuration is defined in 
the relevant recorded magnetic tape standards. 

VOLUflE 

A physical unit of storage media. The word "volume"! as used in 
reference to labels-i is completely synonymous with "reel of 
magnetic tape". 
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KRONOS 2.1 


■0 T) O 
3> 30 O 

o on 
o o c 

C C 2 

o n m 


STANDARD CHARACTER SETS FOR MAGNETIC TAPES 



+ Twelve or more zero bits at the end of a bO-bit word are interpreted as end-of-line 
mark rather than two colons. End-of-line mark is converted to external BCD lb32. 


2 z ^ 
o > o 

D 2 r 
m m > 

n ^ 

</> 

z i 

o 


m 7K m 
a po 
o o c/) 
o z 

¥r O 

nj t/} 
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PRINTED IN USA 


CDC 

Craphic 


ASCII^ 

Graphic 

Subset 



Hollerith 
Display Punch 

Code {QPb} 


11-M 


11-S 



11-b 


11-7 


11-fi 


11-T 



ASCII 

Punch 

105^} 


ASCII 

Code 


11-M 1 ^D 

11-S 

11-b ^F 

11-7 SO 

11-fl SI 

11-S 55 

0-2 S3 

0-3 SM 

0-M SS 

0-S St, 

0-t. 57 

0-7 Sfi 

0-a SS 

D-S SA 

0 30 

1 31 

2 32 

3 33 

M 3M 


• 0*0 0 
30 :» o 


o o n 


o o cr 


CCS 


r> o m 


H H Z 



UJ 

-o 
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> 

> 




CPC 

Graphic 

ASCII 

Graphic 

Subset 

Pisplay 

Code 

Hollerith 

Punch 

{05b} 

External 

BCP 

Code 

ASCII 

Punch 

{05*3} 

ASCII 

Code 

5 

S 

MO 

S 

OS 

S 

3S 

(3 

b 

Ml 

b 

Ob 

b 

3b 

7 

7 

MS 

7 

07 

7 

37 

fi 

6 

M3 

B 

10 

a 

3a 


=3 

MM 

“3 

11 

T 

3*3 

+ 

+ 

MS 

15 

bO 

15-a-b 

5B 

- 


Mb 

11 

MO 

11 

5P 



M7 

11-fl-M 

SM 

11 -a-M 

5A 

/ 

/ 

SO 

0-1 

51 

0-1 

5F 

■c 

{ 

SI 

0-fi-M 

3M 

15-a-s 

sa 

} 

> 

SS 

15-fl-M 

7M 

11 -a-s 


$ 

$ 

S3 

ll-a-3 

S3 

1 

ii-a-3 

BM 

= 

= 

SM 

a-3 

13 

fl — [□ 

3P 

blank 

blank 

SS 

no punch 

50 

no punch 

50 

1 {commaJ 

1 {comma} 

Sb 

o-a-3 

33 

O-a-3 

BC 

.{period} 

.{period} 

S7 

15-a-3 

73 

15-a-3 

BE 

:E 


bO 

1 0 -a-b 

3b 

a-3 

53 

c I 

L 

j 

bl 

i 

1 a-7 

; 17 

iB-a-3 

SB 

3 i 

1 

i ^ i 

1 _ _ 

bS 

o-a-5 

i 

ii-a-5 

1 SP 

I 


TJ TJ O 

7) o 
o o o 
o o c: 
c c z 
n o m 

H H 2: 

Z Z 
o > n 
o z r- 
m m > 

t/i 
CO 

z ■ 
o 


m 

a 

03 

ru 

b*^ 


m 

70 


o 

i/i 

ru 




z 

> 

o 

X 


m 

CO 

m 

5 

m 

CO 

cr 

a 

a 

a 

\ 

ri 

n 

ri 

“C 

CD 

m 

70 

nj 

-nJ 

UJ 

jr 


-v 

> 

o 

m 


> 

I 

LU 


70 

(0 

< 


2 

< 
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CDC 

Graphic 

ASCII^ 

Graphic 

Subset 

Display 

Code 

Hollerith 

Punch 

{DBb} 

External 

BCD 

Code 

ASCII 

Pun ch 
{05^} 

ASCII 

Code 










G3 

fi-b 

lb 

0 -a-M 

55 


"{quote> 

m 

a-M 

m 

a-7 

55 

-> 

_{unclerline> 

t>5 

D-a-s 

35 

o-a-5 

5F 

V 

f 

m 

bb 

11-0 

55 

i5-a-7 

51 

A 

& 

t? 

o-a-7 

37 

15 

5b 

t 

'{apostrophe} 

70 

11 -a-s 

55 

a-5 

57 


f 

71 

11 -a-b 

5b 

o-a-7 

3F 

< 

< 

75 

15-0 ' 

75 

15-a-M 

3C 

> 

> 

73 

ii-a-7 

57 

o-a-b 

3E 

< 


7M 

a-s 

15 

a-M 

MO 

> 

\ 

7S 

15-a-s 

75 

o-a-5 

5C 

-- 

--Micircumflex} 

7t 

15-a-b 

7b 

ii-a-7 

5E 

i -Csemi colon> 

] i{semicolon} 

77 

i5-a-7 

77 

ii-a-b 

1 

3B 

! 


f| In installations using the CDC ti3-graphic set-i display code DO has no associated 
graphic or Hollerith code; display code b3 is the colon {fl-E punch}- The selec¬ 
tion of b3 or character set for tapes is an installation option at deadstart- 
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CONTROL DATA CORPORATION 


DIVISION 


DOCUMENT CLASS. 
PRODUCT NAME. 


ERS 


PAGE NO. 


I A-S Rev // i 


KRONOS S.l 


PRODUCT MODEL NO._EDfia»a. l_ 


MACHINE SERIES 


bOdO/C&C CYBER Va-.V'd-.7M 


CONTROL DATA CHARACTER SETS 

SHOUINC TRANSLATIONS BETWEEN DISPLAY CODE AND ASCII/EBCDIC 





ASCII 



EBCDIC 


DISPLAY 

CODE 

UPPER 

CASE 

LOWER 

CASE 

UPPER 

CASE 

LOWER 

CASE 

OCTAL 

CH 

CH 

' HEX 

CH 

HEX 

CH 

HEX 

CH 

HEX 

00 

• 

• 

m 

• 

3A 

SUB 

lA 

m 

m 

7A 

SUB 

3F 

U1 

A 

A 

m 

a 

bl 

A 

Cl 

a 

ai 

02 

B 

B 

M2 

b 


B 

C2 

b 

BS 

03 

C 

C 

M3 

C 

j 

b3 

C 

C3 

C 

a3 

OM 

D 

D 

MM 

d 

bM 

D 

CM 

d 

aM 

05 

E 

E 

MS 

e 

bS 1 

E 

CS 

0 

as 

Ob 

F 

F 

Mb 

f 

bb 

F 

Cb 

f 

ab 

07 

G 

6 

M7 

g 

b7 

G 

C7 

9 

a7 

10 

H 

H 

Mfi 

h 

bfl 

H 

ca 

h 

aa 

11 

I 

I 

MT 

i 

bT 

I 

CT 

i 

a^i 

12 

J 

J 

MA 

j 

bA 

J 

D1 

j 

^1 

13 

i 

K 1 

K 

MB 

k 

bB 

1 

K 

D2 

k 

■=12 

m 

L 

L 

MC 

1 

bC 

L 

D3 

1 

^3 

IS 

n 

n 

MD 

m 

bD 

n 

DM 

m 

TM 

lb 

N 

N 

ME 

n 

bE 

N 

DS 

n 

IS 

17 

0 

0 

MF 

o 

bF 

0 

Db 

o 

■^b 

20 

p 

P 

50 

P 

70 

P 

D7 

P 

^7 

21 

d 

d 

J 

SI 

1 

1_i 

q 

i_ 

71 

i 

d 

Dfl 

I ^ 

^a 


AA 37T7 


PRINTED IN USA. 



CONTROL DATA CORPORATION 


DIVISION 


DOCUMENT CLASS_ 

PRODUCT NAME_ 

PRODUCT MODEL NO. 


ERS _ 

KRQNOS 2.1 
EDfia*2.1 


_ PAGE NO.I —tzk — 

MACHINE SERIES CYBER 75 i J?3i 


7M 





ASCII 



EBCDIC 


DISPLAY 









CODE 


UPPER 

LOWER 

UPPER 

LOWER 



CASE 

CASE 

CASE 

CASE 

OCTAL 

CH 

CH 

HEX 

CH 

HEX 

CH 

HEX 

CH 

HEX 

22 

I 

R 

R 

52 

P 

72 

R 

DT 

r 

TT 

23 

S 

S 

S3 

s 

73 

S 

E2 

s 

A2 

2M 

T 


SM 

t 

7M 


E3 

t 

A3 

25 

U 


55 

u 

75 


EM 

u 

AM 

2b 

V . 


5b 

V 

7b 


ES 

V 

AS 

27 

(J 


57 

w 

77 


Eb 

w 

Ab 

30 

X 


sa 1 

X 

7a 


E7 

X 

A7 

31 



ST 

y 

7T 


Ea 

y 

Aa 

32 1 

2 


SA 1 

z 

7A 


ET 

Z 

AT 

i 

33 

0 

□ 

30 

DLE 

10 

0 

FO 

DLE 

10 

3W 

1 

1 

31 

DCl 

11 

1 

FI 

DCl 

11 

35 

2 

2 

32 

DC2 

12 

2 

F2 

DC2 

12 

3b 

3 

3 

33 

DC3 

13 

3 

F3 

Tfl 

13 

37 

M 

M 

3M 

DCM 

IM 

M 

FM 

DCM 

3C 

MD 

5 

5 

35 

NAK 

15 

5 

FS 

NAK 

3D 

Ml 

b 

b 

3b 

SYN 

lb 

b 

Fb 

SYN 

32 

! 

M2 

7 

7 

37 

ETB 

17 

7 

F7 

ETB 

2b 

M3 

& 

a 

3a 

CAN 

la 

a 

Fa 

CAN 

la 

MM 

=i 

1 

' 3T 

i 

EH 

IT 

T 

FT 

EH 

IT 

MS 

+ 

+ 

2B 

VT 

OB 

+ 

ME 

! VT 

1 

OB 

Mb 

- 

i 

i 

_1 

2D 

I 

i- 1 

CR 

OD 

i_ 

- 

bO 

i 

; CR 

i —, - 

OD 
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DIVISION 


DOCUMENT CLASS_- PAGE NO-J- 

PRODUCT NAME_KRONOS rvorp -7=1 

PRODUCT MODEL NO. _MACHINE SERIES 


7M 





ASCII 



EBCDIC 


DISPLAY 

CODE 

UPPER 

CASE 

LOWER 

CASE 

UPPER 

CASE 

LOWER 

CASE 

OCTAL 

CH 

CH 

HEX 

CH 

HEX 

CH 

HEX 

CH 

HEX 

M7 


* 

2A 

LF 

OA 


SC 

LF 

2S 

so 

/ 

/ 

2F 

SI 

OF 

/ 

LI 

SI 

OF 

51 

■c 

{ 

25 

BS 

□ fi 

1 

•C 

MD 

BS 

IL 

sa 

I 

> 

2T 

HT 

DT 

} 

SD 

HT 

05 

S3 

$ 

$ 

2M 

EOT 

DM 

$ 

SB 

EOT 

37 

SM 

= 

=: 

3D 

6S 

ID 

= 

7E 

IGS 

ID 

SS 

SP 

SP 

20 1 

NUL 

DO 

SP 

MO 

NUL 

00 

St. 

T 

1 

2C 

1 

DC 


LB 

FF : 

OC 

S7 

m 

• 

2E 

SO 

DE 

• 

MB 

SO 

OE 

i 

to 

= 


23 

ETX 

03 


7B 

ETX 

03 

LI 

c 

c 

SB 

FS 

1C 

(d 

MA 

IFS 

1C 

L5 


3 

SD 

SOH 

01 

f 

• 

SA 

SOH 

01 

h.3 

j 


2S 

1 

EN(3 

OS 

5: 

LC 

EN(3 

2D 

m 


Wf 

22 

STX 

02 

n 

7F 

STX 

02 

LS 

1 


5F 

DEL 1 

7F 

■ 

LD 

DEL 

07 

Lt. 1 

V 

f 

• 

21 

1 

^ I 

7D 

1 

MF 


DO 

b7 

A 

& 

I 

2L 

ACK 

Ot. 

& 

SO 

ACK 

2E 

70 

t 

1 

27 

: 1 

BEL 

07 

t 

7D 

BEL 

2F 

71 i 


f 

1 

3F 

! 

US I 

j IF 

f 

LF 

lUS 

IF 

72 

< 

1 < 

I 

3C 

1 

7B 

< 

MC 


CO 
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DIVISION 


DOCUMENT CLASS____ PAGE NO. -I_^ ^ 

PRODUCT NAME KRONOS 5.1 _^_ 

PRODUCT MODEL NO_ EDfl6*5.1 _MACHINE CYBER 7B -i7 3i7M 


DISPLAY 

CODE 


OCTAL 

73 

74 

75 
7b 
77 


CH 


> 

< 

> 



ASCII 



EBCDIC 


UPPER 

LOWER 

UPPER 

LOWER 

CASE 

CASE 

CASE 

CASE 

CH 1 

HEX 

CH 

HEX 

CH 

HEX 

CH 

HEX 

> 

3E 

RS 

IE 

> 

bE 

IRS 

IE 


4D 

\ 

bO 

(® 

7C 

\ 

7T 

\ 

5C 

1 

1 

7C 

\ 

EO 

1 

1 

bA 


5E 


7E 

— 1 

SF 


A1 

• 

1 

3B 

ESC 

IB 

1 

5E 

ESC 

27 


NOTES: 

1. The terms "upper case" and "lower case" apply only to the case 
conversionsT and do not necessarily reflect any true "case". 

5* When translating from Display Code to ASCII/EBCDICt the "upper 
case" equivalent character is taken- 

3. When translating from ASCII/EBCDIC to Display Codei the "upper 
case" and "lower case" characters fold together to a single 
Display Code equivalent character. 

4. All EBCDIC codes not listed are translated to Display Code 55 CSP}. 

5« If a T track tape is read with ASCII conversion! and a character 
value above 7F is encountered! a flag word error will be given- 

b- In a b3-character set system! the display code for the : graphic 
is b3. The character does not exist! and translations from 
ASCII/EBCDIC '/i or ENi3 yield blank -C55g}. 
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___DIVISION 

DOCUMENT CLASS__ PAf:F Nin I B-1 Rey 

PRODUCT NAME_ K RON OS S.l _ 

PRODUCT MODEL Nin E0fl6»S.l _ MACHINE SERIES . '*^^ 

APPENDIX B 

MAGNETIC TAPE LABELS 
ANSI Labels 

KRONOS system file labels are defined for files recorded on 1/5 inch 
magnetic tape. These labels are designed to conform to the American 
National Standard Magnetic Tape Labels for Information Interchange 
X3.57-nbT. 

XRONOS system labels are recorded at the same density as the data on 
the tape. All system labels are flO characters in length. 

The first three characters of an ANSI label identify the label type. 

The four .:ri character indicates a number within the label type. 


lyp.e 

No. 

Label Name 


Used At 



VOL 

1 

Volume header label 

Beginning of 

volume 

Required 

UVL 

l-T 

User volume 

label 

Beginning of 

volume 

Optional 

HDR 

1 

File header 

label 

Beginning of 

file 

Required 

HDR 

a-T 

File header 

label 

Beginning of 

file 

Optional 

UHL 

+ 

User header 

label 

Beginning of 

file 

Optional 

EOF 

1 

End-of-file 

label 

End of file 


Required 

EOF 

a-T 

End-of-file 

label 

End of file 


Optional 

EOV 

1 

End-of-volume label 

End of volume 


Required when 







appropriate 

EOV 

a-T 

End-of-volume label 

End of volume 

Optional 

UTL 

+ 

User trailer 

■ label 

End of file 


Optional 


+ Any member of CDC b-bit subset of ASCII character set. 
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ERS 

- -- PAnF NO I _ 

B-5 

PRODUCT NAME ... 

KRONOS 5.1 



PRODUCT MODEL NO. 

EDaa*B.i 

MACHINE SERIES 

CYBER 75-,73-.7M 


TAPE FILE STRUCTURE 

KRONOS standard system labels and tape marks establish the tape file 
structure according to the following rules. Required labels are indi¬ 
cated by a M-character identifier! and tape marks are indicated by 
asterisks. In all the cases belowi optional labels are placed as 
follows: 

HDR5 through HDRT may immediately follow HDRl. 

E0F5 through EOFT may immediately follow EOFl. 

E0V2 through EOVT may immediately follow EOVl. 

UVLCa> {User Volume Label} may immediately follow VOLl. 

UHLIa} {User Header Label} may immediately follow the last H]>R{n} 
label. 

UTL{a> {User Trailer Label} may immediately follow the last E0V{n} 
or E0F{n} label. 

{a} indicates any b-bit CDC character. {n} indicates any numeric 
character. 


Single-Volume File 


VOLl HDRl^ ..• Data Blocks 


*E0F1** 


Multi-Volume File 

VOLl HDRl* ... First Volume Data ... *E0V1** 
VOLl HDRl* ... Last Volume Data ... *E0F1** 


Multi-File Volume 

VOLl HDRl* ... File A ... *E0F1*HDR1* .... File B ...-.*E0F1** 
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_DIVISION 

DOCUMENT CLASS__ PAGE NO. -I_ 6-3 

PRODUCT NAME_ KRONOS 5.1 _ 

PRODUCT MODEL NO_ EOfiS^g. 1 _MACHINE ^000/CYBER 7g-i7 3i7H 

flulti-Volume Multi-File 

VOLl HDRl* ... File A ... *E0F1THDR1T ... File B ... *E0V1** 

VOLl HDRl* ... Continuation of File B ... *E0V1** 

VOLi HDRl* ... Last of File B ... ^EOFl^HDRl^^; ... File C ... *E0F1** 
Volume Header Label 

The first PRU in the volume must be a volume header labeli it may not 
appear elsewhere. 

File Header Label 

Every file must be preceded by a file header label and every file 
header must be preceded by a tape mark or a volume header label. When 
a volume ends within a filen the continuation of that file in the next 
volume must also be preceded by a file header. 

File Trailer Label 

A file trailer label is required as the last block of every file. A 
file trailer must be preceded and followed by a tape markn and if it 
is the last file trailer in the volumen two following tape marks are 
required. 

Volume Trailer Label 

Uhen a volume ends within a filei the last PRU of the file in that 
volume must be followed by a volume trailer label which must be pre¬ 
ceded and followed by tape marks. 

Uhen end-of-volume and end-of-file coincide! the labeling configuration 
is one of the following indicates tape mark}: 
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DOCUMENT CLASS_ 

PRODUCT NAME_ 

PRODUCT MODEL NO. 


ERS 

Eoafi»g.i 


-DIVISION 

_ PAGE NO.-^____ 

MACHINE fc’OQD/CDC CYBER TgiT BiTN 


VOLl HDRl* ... File A ... *E0V1** 

VOLl HDRl*!tcEOFl*HDRl ... File B ... *E0F1** 



■CA> 

{A} -CB} 


VOLi 

HDRl* 

Fils A 

*E0Fl>i:HI>Rl**E0Vl 


■CA} 


■CB} 

VOLl 

HDRl* 

••• Fils B ••• 

*E0Fl*5i? 


■CB} 



VOLl 

HDRl* 

••• Fils A ••• 

5|«EOFl*EOVl*5f: 


■CA} 


■CA} 

VOLl 

HDRl* 

m m m FllS B ••• 

*E0F1** 


■CB} 


■CB} 


ANSI labels 

The labels processed by KRONOS are the ANSI labels which follow: 
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Character 

Position 

Field 

ANSI Name 

CKRONOS Name! 

Length 

Contents 

Default 

Written 

Checked 
On Read 

DOCUMENT CL AS*; ERS . 

PRODUCT NAME ..KRONOS 5_.Ji_ _ _ . 

PRODUCT MODEL NO. £066*5.1 __ _ _ 

Volume 

Header 

Label 

l1-3_ 

1 

Label Identifier 

3 

VOL 

VOL 

Yes 


5 

Label Number ' 

1 

1 

1 

Yes 

S-ID 

3 

Volume Serial 
Number 

b 

Any ”a" 
characters 

As 

speci¬ 

fied 

Yes if 
file 

assigned 
by VSN 

11 

' M 

Accessibility 

1 

1 "a" 
character 

space 

No*^ 

15-31 

5 

Reserved 

50 

spaces 

spaces 

No 

35-37 

h 

Reserved 

b 

spaces 

spaces 

No 

3fi-Sl 

7 

Owner ID 

m 

Any "a" 
characters 

Family 

Namei 

User 

Number 

No 

S5-7'l 

6 

Reserved 

56 

spaces 

spaces 

No 

flO 

T 

Label Standard 
Level 

1 

blank 

blank 

No 

j 

1 

First j 

File 

Header I 

Label 

1-3 

1 

Label Identifier 

3 

HDR 

HDR 

Yes 

z 

> 

n 

E 

z 

m 

y) 

m 

i 

5 

Label Number 

1 

1 

1 

Yes ; 

! 5-51 

[ 

3 

File Identifier 

i 

17 

Any "a" 
characters 

spaces 

Yes ' 

1 

1 

55-57 


Set Identifica¬ 
tion 

b 

Any "a" 
characters 

blank 

No* j 

[T £5 
a rn 

a o 

"s 

Q H 

n 

r\ 

CD CD 

m * 

xO Cn 

xD 

ro 

ru < 

Xi ^ 

Ul 

56-31 

1 

5 

File Section 
Number 


characters 
indicating 
number of 
volume in 
file 

□ □□1 

Yes 

* Check if specified. 

** See Section 3.5.S. 


-o 

JZ 
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Character 

Position 

Field 

ANSI Name 
{KRONOS Name} 

Length 

Contents 

Default 

Written 

Checked 
On Read 

-D a 

73 O 

o o n 

m 1-1 r* 


3S-3S 

b 

File Sequence 
Number 


characters 
indicating 
number of file 
in multi-file 
set 

0001 

Yes 

d 

n 

H 

3 

O 

o 

m 

z 

p 

c: 3 
n m 

H 2 

2 -J 
> n 

X r‘ 
m > 

iA 

lA 

7^ m 
70 73 

o n 

o 

nj 

• 

IH 

13 

> 

O 

m 

2 

P 

M 

CD 

1 

DT 

fD 

< 


7 

Generation 

Number 

4 

characters 

ODDI 

No* 

m 

o 

03 

o* 

* 

m 

• 

-z 

MD-m 

a 

Generation 
Version Number 

B 

B ”n" 

characters 
indicating the 
edition of file 

00 

Yes 

M5-H7 


Creation Date 

b 

Space followed 
by B "n” char¬ 
acters for 
year 1 3 "n" 
characters 
for day 

Current 
date is 
used 

Yes 

Ha-S3 

; 10 

Expiration Date 

y 

Same as field 

T 

Same as 
field T 

Yes i 

SH 

' 11 

Accessibility 

1 

Any "a" 
characters 

space 

> 

No** n 

X 

. *5^ 

SS-bD 

IB 

Block Count 

b 

Zeros 

Zeros 

Ki ^ 

No CO 

bl-73 

13 

j System Code 

1 

13 

Any "a" 
characters 

KRONOS 

B• 1 -nn 

{Where 

nn-EST 

ordinal 

of unit 

written 

on.} 

No 

m 

5 

T1 

yi 

cr 

a 

C3 

a 

\ 

ni 

n 

n 

-< 

w 

m 

70 

-o 

nj 

UJ 

7M-aD 

■01 

Reserved 

7 

spaces 

HSHI 

No 

* Check if specified. 

See Secfxon 3*2.S. 


2 

< 

O 

z 


* Check if specified 
j S ©0 Section 3«5«S 
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VSDNKBINUU 


> 

> 

iM 



Character 

Position 

Field 

ANSI Name 
-CKRONOS Name} 

Length 

Contents 

Default 

Written 

Checked : 
On Read i 

Additional 

File 

Header 

Labels 

1-3 

1 

Label Identifier 

3 

HDR 

HDR 

Yes ' 


a 

Label Number 

1 

a-4 

a-T 

Yes i 

All other fields are not checked on readi they are written as received by 
KRONOS from user* 

First 

End-of- 

File 

Label 

1-3 

1 

Label Identifier 

3 

EOF 

EOF 

Yes 

4 

a 

Label Number 

1 

1 

1 

Yes 

S-S4 

3-11 

Same as corres¬ 
ponding HDRl 
label fields 


■ 



SS-bD 

la 

Block Count 

b 

b "n" 

charactersT 
number of 
data blocks 
since last 

HDR label 
group 


Yes 

bi-ao 

13-14 

Same as corres¬ 
ponding HDRl 
label fields 





Additional 

End-of- 

File 

Labels 

1-3 

1 

Label Identifier 

3 

EOF 

EOF 

Yes : 

4 

a 

Label Number 

1 

S-H 

a-T 

Yes i 

All other fields are not checked on readi they are written as received by : 
KRONOS from user. 1 

First 

End-of- 

Volume 

Label 

1-3 

1 

Label Identifier 

3 

EOV 

EOV 

Yes 

4 

a 

Label Number 

1 

1 

1 

Yes 

All other ■ 

Fields are identical to EOFl label. 

Additional 

End-of- 

Volume 

Labels 

1-3 

1 

Label Identifier 

3 

EOF 

EOF 

Yes 

4 

a 

Label Number 

1 

a-T 

a-T 

Yes 

All other fields are not checked on readi they are written as received by 
KRONOS from user. 


^ P 
;o o 
o n 
o c 

C 3 

o m 
H z 
^ H 








m 

\?o 


CD 

I 

-O 


-V 

> 

o 

m 


o 


o 

< 

sc 

o 

z 


-nJ 

XT 
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> 

> 

55 



Character 

Position 

Field 

ANSI Name 
■CKRONOS Name! 

Length 

Default 

Contents Written 

Checked 
On Read 

USER 

Labels 

1-3 

1 

Label Identifier 

3 

3 letter codei UVLi UHLi 
or UTL 

Yes 

M-ao 

Any ”a" characters. Content of these fields is not checked on 
readi is written as received by KRONOS from the user. 


D "O O 
O 

o o n 
o o c 
-c c z 
o o m 
H H z 

2 z 

o zP 
m m > 

— tn 
iA 


2 

X 


m 

tn 

m 

m 

iA 


m 

t/O 


> 

o 

m 

z 

o 


2 

< 

iA 

O 


M 


CD 

I 

O 
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-DIVISION 

DOCUMENT CLASS__ PAr,F nd I ^ I 

PRODUCT NAME_ KRONOS 5.1 _ 

PRODUCT MODEL NO_ EDflfl*a« 1 _MACHINE CYBER Tg-iTB iTM 

APPENDIX C 

TAPE ASSOCIATED DISPLAYS 

The displays related to magnetic tape processing are the EiT. and 
EiP* displays* These displays are subsets of the E display* 


EiT* 

Display 







TAPE 

STATUS 







E(3 

VSN 

DEN 

R 

F 

CP 

JOB 

STATUS 

HTQO 

ia3MSb 

auo 

IN 

I 

a* 

TESABCDB 

READY 


ABCDEFCHIJKLI1N0PI3 




riTDl 







IDLE 

MTOa 

SCRATCH 

fiOO 


S 


AA(3 BOOST 

LOADPT 

riToa 


SSL 


X 

a* 

TESABCDB 

READY 

NTDM 

VOLUME 

IbOO 

IN 

SI 


SCPTAAiJB 

ROLLED 


KRONOS 

TAPE 






NT05 







DO UN 

NTOb 

UNITQb 

aoD 


F 

3. 

TESABCDB 

READY 


E(2 = Equipment 

MTuu = seven tracki uu = unit number 
NTuu = nine tracki uu = unit number 

VSN = Volume Serial Number 

Volume Serial Number Cl-L characters} 
File Identifier -Cl-17 characters} 

DEN = Density! will be one of: 
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PRODUCT NAME_ KRONOS B. l _____ 

PRODUCT MODEL NO_ EDfifi^S . 1 _MACHINE bOOO/CDC CYBER ?Si7 3->7M 


absent 

200 

5Sb 

aoo 

IbOO 

R = Ring Statusi will be one of: 

IN if ring in 
absent if ring out 

F = Format 1 will be one of IL format will be displayed as S}: 
I 

SI 

X 

S 

E 

B 

F 


CP = Control Point 

JOB = Jobname and origin 

STATUS = Status 1 will be one of: 

READY 

IDLE 

LOADPT 

ROLLED 

DOUN 

2* EnP- Display 
PREVIEU 


JOB 

VSN 

Ed? 

JOB 

VSN 

E(2 

SCPDAABB 

TAPE'IT 

NT 

PFTTAANB 

RPACD02 

DIE 


JOB = Jobname and origin 

VSN = Volume Serial Number or Packname 

E(2 = Resource type 
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DIVISION 


DOCUMENT CLASS__ 

PRODUCT NA|^E_ KRONOS S.l 

PRODUCT model no_ £053*5.1 


PAGE NO. J 


MACHINE SERIES 


■GQ007Cl>C'TY'B-£ R.75.7 3.7 M 


APPENDIX D 

END OF TAPE and TAPE FORMATS 


DEFINITIONS; 

BINARY 

No code conversion performed. 7 track and T track both are 
written and read in odd parity. 

CODED 

7 track is written and read in even parity. T track is written 
and read in odd parity. On 7 tracki code conversion will be 
performed between external BCD and display code. On T tracki 
read conversion will be performed from an eight bit ASCII or 
EBCDIC character to a six bit display code character. On T 
track writeT six bit display code characters will be mapped to 
eight bit ASCII or EBCDIC characters- The selection of ASCII 
or EBCDIC is a user option. 

END OF TAPE 

The following are the user options available when End-of-Tape {EOT} 
is sensed. 

1. On write when EOT is sensed the block on which EOT occurred 
will be rewritten as the first block on the following reel. 

No trailer information will be placed on the current reel. 

On read the block on which EOT occurred will be discarded and 
the read will continue on the next reel. If a tape mark and 
EOT occur at the same timei EOT will be ignored. {This is 
compatible with KRONOS S-Q.} 
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DIVISION 


DOCUMENT CLASS_E^I_ PAGE NO.I _I>~5 Rev // ] _ 

PRODUCT NAME _ KRQNOS S.l _ 

PRODUCT MODEL Nir> £066*5.1 _MACHINE SERIES taPOQ/QC ..CYBER 7a,-..73t7H 

2» On write tape marks will be written following the block on 
which EOT was sensed. The write will then continue on the 
next reel. On read the block on which EOT is sensed as well 
as all following blocks will be transferred to the user 
until a tape mark is sensed. The read will then continue 
on the next reel. If a tape mark and EOT are sensed at the 
same time then EOT will be ignored {SCOPE 3.M unlabeled 
compatible!. 

3. On write when an EOT is sensed a trailer label sequence {tape 
mark plus EOVl label! will be written following that block. 

The next block will then be written on the next reel. On 
readn an EOT will be ignored. A read will stop at a tape 
mark followed by an EOVl label. Reading will then continue 
on the next reel. 

USER ERROR PROCESSING BY EP BIT 

If the user wishes to do his own error processing! the EP bit 
{bit MM in FET+1! must be set {EP=l!. If default RPE/UPE pro¬ 
cessing has been selected and EP is setn the error code of M 
will be returned in bits 10-13 of FET+0 if an unrecoverable tape 
error is detected. 

RElilINO/UNLOAD PROCESSING 

Any time a REUIND/UN LOAD is performed and the last operation on 
the tape was a write the following will be performed. 

1. On an unlabeled tape {except It SI format! four tape marks 
will be written. 
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PRODUCT MODEL Kin _MACHINE cppiPS fc-DDD/CDC CYBER 75-i7 3-i7M 

B. On a labeled tape -Cunlabeled In SI format also! a trailer 
label sequence will be written* 

Positioning of the tape after a REWIND will be as follows: 

1. If user processing selectedn the tape will be positioned at 
the beginning of data for the current reel or current file 
whichever occurred first {where file is in reference to a 
multi-file tape>. 

B. If no user processing selectedn positioning will be at the 
beginning of file. If this requires backing over reels this 
will be done transparently to the user. The system will 
request the appropriate previous reel based on the VSN file. 

If tape assignments are being made via the old method of 
operator assignment of equipment numbers and thus the system 
is assigning default VSN*sn then multi reel operations may 
leave the operator confused as to what reel to mount. 

The following defines the action taken by the system when end-of- 
reel is encountered during tape operations {where occurrence of 
end-of-reel is as defined by one of the options specified earlier!- 
1. User processing not selected in FET 

a- Processing will continue as if user had performed a 
CLOSER function without user processing selected {see 
definition of CLOSER}. 

B. User processing selected in FET 

a- Control will be returned to the calling program with end- 
of-reel status set in the FET. Tape will be positioned 
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SO that if user attempts to perform another I/O operation 
the result will be the same. Thusi a user cannot run off 
end of reel. 

b. The user would not normally either issue a CLOSER func¬ 
tion or an unload. -CSee definition of these functions.} 

3. REti)INI> and UNLOAD after end of reel as well as CLOSER at all 

times will cause the following to occur: 

a. If the last operation on the tape was a write: 

1} If unlabeledi a tape mark will be written. 

S} If labeled! a trailer label sequence will be written, 
a} If next VSN has been previously declared-i an 

optional operating system label will be written 
containing the VSN of the next reel, 
b} If next VSN has not been declared before! the 
trailer label sequence will not be performed 
until the operator has specified the next VSN. 

Then action will continue as in step above. 

3} If I or SI format and unlabeled! the optional operat¬ 
ing system label will be written only if the VSN has 
been previously specified or if the VSN specified by 
the operator was not a system default VSN- 

b. If the last operation on the tape was a read: 

1} If next VSN for the tape previously declared! proceed 
to 3.C. 

5} If next VSN not previously declared and if tape has a 
trailer label sequence on it with an optional operat- 
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ing system label of the correct format then extract 
the next VSN otherwise continue. 

c. The present reel will be rewound and -Cor} unloaded. 

d. If a CLOSER operation without UPi the type is declared as 
labeled-i and the FET is long enough to allow for a label 
field-! the file section number will be incremented in the 
users FET. 

e. The FET is completed. If CLOSER with user processing 
selected-I end-of-reel status is returned again. 

M. Continuation of operation on next reel: 

a. If VSN for next reel is not yet known-i then notify operator 
next VSN needs to be specified. 

b. When next VSN is known for file request operator to 
mount it if it is not already mounted. This new tape 
does not have to be on the same drive as the previous one. 

S. If labeled operation-i the calling program may do an open on 

the file to get label information returned to its buffer. 

BLOCK TERMINATOR 

A block terminator will be used after certain data blocks as 
specified below. This block terminator will be in one of two 
formats: 
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!• Binary Mode Block Terminator Format 


B. 


M7 35 11 3 0 


BYTE 

COUNT 

BLOCK NUMBER 

0 

LN 


BYTE COUNT = Total number of bytes in the block including 
the block terminator. 

BLOCK NUMBER = Count of blocks since the last "HDRl” label. 
LN = Level number. 

Coded Mode Block Terminator Format prior to Code Conversion 


H7 


7 BLANKS {55} 


LN 


where L = 55 for level Di L = 1 through 17 for all other levels. 


Block Terminator Usage: 

1. All data blocks in I format will have a block terminator 
except for labels. 

B. All data blocks of less than lOQDB CM words for binary or 
BOOB CM words for coded will have a block terminator for 
SI format. 
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PHYSICAL CHARACTERISTICS; 

I Format -Clnternall 
1. flode 

Binary always. CODED/BINARY bit -Cbit 1 in word 0 of FET> in 
the FET has no meaning. 

5. Block Size 

The actual data block will range from 0 to lODOB CM words in 
exact multiples of CM words. All blocks will include a block 
terminator except for labels. A block may contain only a 
block terminator. User specified frame or character counts 
have no meaning. 

3. EOR 

Any block with less than IQDDB CM words of data will repre¬ 
sent an EOR. The level number field will contain the level 
number from the FET or control word -CSOM CIO code>. On read 
an EOR and the contents of the level field will be returned. 

If level 17T then EOF will be returned also. 

M. EOF 

An EOF will be block consisting of only a block terminator 
with a level of 17. The system will also insure that an EOR 
will always precede an EOF by writing a block terminator with 
a level of 0 if necessary prior to EOF. 

S. EOI 

A tape mark followed by an EOFl label. If a tape mark is 
encountered without a valid label following! it will be 
considered as an error. 


AA 3777 


raiNIB) IN U&A. 



CONTROL DATA CORPORATION 

. .DIVISION 

DOCUMENT CLASS__ PAGE Kin I ^ I 

PRODUCT NAME_ KRONOS 5.1 _ ■ 

PRODUCT MODEL NO_ EDfi6»5.1 _MACHINE SFRiPS faPDD/CPC CYBER 7517 3 •i7M 


End of Reel 

See Item 3 under end of tape. 

7. Noise 

All blocks of less than 7 frames {7 track} or S frames 

•CT track} will be considered as noise, 
fl. Other 

a. All T track tapes will be written as an even multiple of 
bytes such that fill status will never occur. 

b. All reads will check both the block length read and the 
block number expected against those in the block termina¬ 
tor as well as checking for fill status where available. 

If any of these occuri messages will be issued and recovery 
procedures initiated. This should in general prevent 
dropped blocksi etc. This should provide a much higher 
degree of reliability than any other format- 


SI Format {SCOPE Internal} 

1. node 

Binary or coded determined by BINARY/COOED bit in the FET 
{bit 1 in word D of FET}. 

S. Block Size 

The actual data block will range from 0 to lOODB Cn words for 
binary in exact multiples of Cn words {Q to SOOB for coded}. 

All blocks less than the maximum size will include a block 
terminator except for labels. A block may contain only a block 
terminator. User specified frame or character counts have no 
meaning. 
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3. EOR 

Any block with less than lOODB CM words of data will repre¬ 
sent an EOR* The level number field on write will contain 
the level number from the FET or control word <H0M CIO code}. 

On read an EOR and the contents of the level field will be 
returned. If level 17i then EOF will be returned also. 

M. EOF 

Same as I mode. 

5. EOI 

Same as I mode, 
b. End of Reel 

Same as I mode. 

7. Noise 

Same as I mode, 
fl. Other 

a. All T track tapes will be written with 3N + E to insure 
exact frame count. 

b. No block validation checking will be done, 
c* Code conversion will be as follows: 

1} 7 track see coded data conversion- 

S> T track no conversion performed- 
d. On a coded 7 track tape a lb3E external BCD in byte M of 
position of a CM word represents an end of line □□□□ in 
display code. 
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X Format -CExternal - KRONOS 2»D Binary Compatible} 

1. Node 

Same as I format. 

2. Block Size 

The data block will range from D to lODOB CM wohds* Only a 
block terminator will be appended in the case of a 0 CM word 
count. All blocks must be an exact multiple of CM words* 

3. EOR 

Any block with less than lOOOB CM words of data will repre¬ 
sent an EOR. Level numbers 1 through IL will be considered 
as level □. 

M. EOF 

Tape mark. Cannot be labeled. 

5. EOI 
None. 

b. End of Reel 

See Item 1 under end of tape. 

T. Noise 

Same as I mode. 

6. Other 

a. Same as KRONOS 2*0 Standard Binary Tape. 
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S <L> Format -CSCOPE STRANGER/LONG Record} 

1. Node 

Same as SI format* 

2* Block Size 

Cannot be greater than CN buffer size* No explicit multiple 
of frames required. Naximum block size may be either desig¬ 
nated at tape request time or through the NLRS field in the 
FET* Once a value is established! howeveri that value will 
be used for all further operations even though the FET might 
contain a different NLRS value. The block size is used to 
determine whether to continue reads or writes based on data/ 
room in buffer. Thusi one should not simply pick some large 
value for this number. 

3. EOR 
None. 

M. EOF 

Tape mark. 

S. EOI 

If unlabeledi none. If labeled! tape mark plus EOFl label, 
b. End of Reel 

See Item 2 under end of tape. 

7. Noise 

All blocks of less than IS frames 17 track} or 12 frames 
n track}. 
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bOOO/CBC CV0ER '7?;73-,7M 


fl. Other 

a. CIO codes 10 1 m-i and 3M all perform a one block 

operation CPRU operation}- With the unused bit count 
and the word count being taken from/returned to the FET- 

b. CIO codes EQOi HDHt atOi and all perform as normal 
except for level numbers. 

c- Level numbers 1 through IL will be considered as 0- 

d- Code conversion applies to both 7 and T track. 


E Format -GLine Image Mode - Coded Only} 

1. Code Only 

BINARY/CODED bit in FET is ignored. 

2. Block Size 

Cannot be greater than S12D frames- Some hardware will not 
allow odd number of frames to be written. In this case a 
space will be appended. Maximum block size will be assumed 
to be 5120 characters unless specified when tape requested. 

3. EOR 

On write none. On read an EOR will be returned when a tape 
mark is encountered. An additional read will then return an 
EOF. 

H. EOF 

Tape mark. 

S. EOI 

If unlabeled-i none. If labeled-) tape mark plus EOFl label- 
b. End of Reel 

See Item 2 under end of tape- 
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7. Noise 

All blocks of less than la frames -C? track} or 15 frames 

•CT track}, 

a. Other 

a. On write E mode will stop at a zero byte in byte four of 
a CM word or it will stop at the multiple of CM words 
based on the character/frame count specified. The buffer 
will then be space filled to the amount of frames speci¬ 
fied. The write will have a length exactly as specified. 

b. On read-i will space fill last b bits of a byte if odd 
number of characters. It will then delete trailing 
spaces. Data is then stored in the buffer with at least 
15 bits of zero insured. 

c. This will provide user same capability as E mode in KRONOS 
5.Qi but some of the end cases are more clearly defined. 


B Format -CBlocked Mode - Coded Only} 

1. Code Only 

BINARY/CODED bit in FET is ignored. 

5. Block Size 

Cannot be greater than S150 frames- Some hardware will not 
allow odd number of frames to be written- In this case a 
space will be appended. Maximum block size will be assumed 
to be S150 characters unless specified when tape requested. 
3. EOR 

On write none. On read an EOR will be returned when a tape 
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mark is encountered. An additional read will then return an 
EOF. 

M. EOF 

Tape mark. 

S. EOI 

If unlabeledn none. If labeledn tape mark plus EOFl label, 

b. End of Reel 

See Item S under end of tape. 

7. Noise 

All blocks of less than Ifi frames I? track} or 15 frames 
n track}, 
fl. Other 

a. On write B mode will stop at the first zero byte encount¬ 
ered at any position in a CM word or at a multiple of CM 
words based on frame/character count specified. Length 
of record written will then be determined by when term¬ 
ination was reached. 

b. On readi it insures one byte of zeroes. 

c. This will provide user same capability as B mode in 
KRONOS 5*On but some of the end cases are more clearly 
defined. 

d. Code conversion applies to both 7 and T track. 
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F Format •CForeign> -Clilill be implemented if time and funding permit.! 
1. node 

Binary -CT trackli BINARY/CODED -C? track} as needed. 

S. Block Size 

Cannot be greater than CM buffer size. No explicit multiple 
of frames required. Naximum block size must be designated at 
tape request time. The block size is used to determine 
whether to continue reads or writes based on data/room in 
buffer. Thusi one should not simply pick some large value 
for this number. 

3. EOR 
None. 

M. EOF 

Tape mark. 

S. EOI 
None. 

b. End of Reel 

See Item 1 under end of tape. 

7. Noise 

All blocks of less than Ifl frames -C? track} or IS frames 
-CT track}, 
fl. Other 

a. In 7 track if a parity error is encountered due to tape 
being written in the opposite mode then the mode will be 
switched. 
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APPENDIX E 
RESOURCE ALLOCATION 

1*0 Resource Assignment Philosophy 

The assignment of magnetic tape and removable disk pack resources 
is done in such a manner so as to prevent a resource deadlock due 
to tape and pack overcommitment* A resource deadlock occurs when 
resources have been assigned in such a manner that by assigning 
the requested resource to the user one of the jobs currently 
having assigned resources cannot go to completion* Resources will 
be overcommitted 1 that isi a job may demand more units than are 
currently free-i as long as there exists a sequence of job comple¬ 
tion which allows all jobs with currently assigned resources to 
complete* 

S.O Resource Demand 

Each job is required to specify its resource demandi that isi 
the maximum number of units that will be in use concurrently for 
each type of resource* Any job which uses only one unit of any 
resource type at a time need not specify its resource demand* 

All resource demands must fall within the user’s validation 
limits and there must be enough units in the installation to 
satisfy the demand* 

5*1 RESOURC Card 

The RESOURC control card is used to specify resource demands* 
This card has the format: 
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RESOURC-CRT, =0, •.RT 3 =n 31 ... iRT^=n^> 

Ji A c c n n 

where: 

RT£ = resource type 

n£ = maximum number of units to be in concurrent use 


2.1.1 Resource Types 

The following mnemonics will be used to Specify the 
type of resource on the RESOURS control card. 

2.1.1.1 Magnetic Tape Resource Types 

MT seven track tape 

NT nine track tape 

2.1.1.2 Removable Pack Resource Types 


DDi 

1 


M 

as3/asM-i 

1 

^ i 

i M 

Dli 

1 

£ i 

a 

aMM-i 

1 

i 

^ a 

MDi 

1 

Ml 

•rl 

Ml 

a 

am-i 

1 

i 

^ a 


2.1.2 As new hardware is developed or other types of hard¬ 
ware need be included in the resource allocation-i 
the mnemonic for the device used for CMRDECK entries 
will be used as the resource type mnemonic. 
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3.0 Implementation Scheme 

When a tape or pack is requested! the current environment is 
examined to determine what tapes and packs are mounted. The 
resource executive determines if the assignment of the requested 
resource will cause a resource deadlock. If such is the case-i 
the requesting job will be event rolled out waiting for a change 
in the environment. If a resource deadlock does not occur t a 
scan for the requested tape or pack is performed. If the requested 
VSN is not found! the VSN is made available for operator previewing 
-Csee Appendix C for Preview Display} and the job is event rolled 
out waiting for the VSN to become part of the environment. If 
the requested tape or pack is found! it is assigned to the 
requestor. 

3.1 Shared Removable Disk Packs 

If a removable pack request finds the pack mounted but 
assigned to another user! the requestor is assigned the 
pack on a "shared" basis. A count of the number of shares 
is kept to determine when the pack may be dismounted. 

The attachment of the first direct access permanent file 
which resides on a sharable pack will charge the pack to 
the job in fulfilling its resource demand. Accesses to 
indirect access permanent files will not be charged if the 
file resides on a sharable packi however! if the pack must 
be mounted to satisfy the request! it will be charged to 
the job in fulfilling the resource demand. 
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APPENDIX F 
ERROR MESSAGES 

Message Data 

Messages are issued in the following format: 
MTnC13-S-DSnABCDEF-,RDnS3-,SD-.3S07-. 3001. 

MT1C13-.F0M-. BN000123-, NNNNNN. 

The first message would tell the following: 

1. Channel 13 t equipment Sn unit B* 

5. Volume Serial Number is "ABCDEF". 

3. Operation was a read. {Any operation not involving an actual 
read or write will be called a read.l 
M. The "S3” is the EST ordinal of the unit the tape was written on. 
This will only be available for labeled tapes generated under 
KRONOS B.l. It will normally be blanks in all other cases. 

S* Status of 

b. Status of controller. 

7. Status - 2 of controller if available. 

The second message would tell the following: 

1. Channel 13 - This is repeated so that if errors are occurring on 
more than one tape channel at the same time the two messages can 
be associated. 

2. The error occurred on a software function M. 

3. The block number the error occurred on was 123. 

Additional description. 
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NO WRITE ENABLE. 

READY DROP. 

EOP TIME OUT. 

WNB TIME OUT. 

CONNECT XPE. 

CONNECT REJECT EXT. 

XPE DATA. 

CONNECT REJECT INT. 

ON THE FLY COR. 

Block Length Errors 

Expected block length will be a meaningless number if truncation 
occurred. 

User Error Messages 

All errors listed here are fatal. 

BLANK TAPE. 

NO WRITE ENABLE. 

BLOCK TOO LARGE. 

BUFFER ARGUMENT ERROR. 

HARDWARE MALFUNCTION. 
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Control Card Error Messages 
♦ARGUMENT ERROR.* 

The usage of a control card parameter is syntactically incorrect. 
♦DUPLICATE VSN.* 

The VSN association for the file has already been established. 
♦MISSING VSN.* 

A VSN has not been supplied by a previous VSN card or the VSN= 
parameter when using the LABEL card. 

♦RESOURCE DEMAND ERROR.* 

The user has attempted to do one of the following: 

1. Request an illegal resource type. 

2. Exceed validation limits for the resource type. 

3. Request more resource units than exist in the installation. 

*4. Use more resource units than the specified demand. 

S. Decrement demand to less than the number of currently assigned 
units. 

L. Increment demand so as to cause a deadlock. 

Tape Assignment Error Messages 
♦FATAL ASSIGNMENT ERRORS.* 

The user has improper ring status or accessibility. The message 
♦IMPROPER RING STATUS.* or ♦IMPROPER ACCESSIBILITY.* will also 
be issued. 
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*NON-MATCHING DENSITY.* 

Density of tape does not agree with requested density. This is 
not-fatal. 

*NON-nATCHING CONVERSION.* 

Conversion mode of tape does not agree with requested specifica¬ 
tion. This is not-fatal. 

*USER NOT VALIDATED.* 

User is not validated for assigned equipment. 

*VSN NOT ASSIGNABLE.* 

VSN is present but is not of correct track type. 

Resource Executive Error Messages 
*DEMAND FILE ERROR.* 

An error has occurred in processing the demand file. 

*ILLEGAL EXTERNAL CALL.* 

A call to the resource executive from using tape request macros 
•CLFM functions!! SCOPE 3.M tape requests -CSFP}t or any removable 
pack request -CPFM functions! is incorrect. 

*OVERCOMMITMENT ALGORITHM ERROR.* 

An error has been detected while executing the overcommitment 
algorithm. 
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JtcRESOURCE ENVIRONMENT ERROR.* 

The resource executive detects an error while extracting informa¬ 
tion from the Mass Storage Tables -CMSTl or from the tape execu¬ 
tive -CMAGNETl. 

*SUB-SYSTEM COMMUNICATION ERROR.* 

The resource executive is unable to communicate with the tape 
executive -CMAGNETI. 
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1.0 SCOPE 

1.1 This document describes the capabilities of the system to 
support permanent file devices in such a way that they can 
be activated in or removed from the system without interruption 
to normal system operation- This includes devices defined 
as removable devices or normal permanent file devices* 
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a.O APPLICABLE DOCUMENTS 


KRONOS V2«l Product Objectives Document E0fl6*2*l 

KRONOS V2*0 Batch User’s Reference Manual S‘^lSDt>DQ-B 

KRONOS V2.0 Time Sharing User’s Reference Manual S^lSlBDD-B 

KRONOS V2.Q Operating Guide S'HSlbOD-B 

KRONOS V2*0 Installation Manual 

Instant KRONOS 


AA 3777 


PfUNIBl IN USA. 



CONTROL DATA CORPORATION 


___DIVISION 

DOCUMENT CLASS__£Ri_ PAGE NO.-II_—J_ 

PRODUCT NAMF KRQNOS g-l __ 

PRODUCT MODEL hin £066*5*1 _MACHINE CFRipc fc»DDD/CI>C CYBER TEt TStTM 

3.0 DESCRIPTION 

Two additional capabilities exist for manipulation of permanent 
file devices in KRONOS 5-1. They are: 

Interchangeability of permanent file families between 
KRONOS 5*1 systems. 

Removable devices. 

The operational characteristics of these features and the user's 
interface to them will be discussed in the following sections. 

3*1 Interchangeability of Permanent File Families 

This feature allows permanent file devices to be introduced into 
an alternate system without interruption to the alternate system- 
installations which have more than one system-, or groups of 
installations, have the capability of connecting the permanent 
file devices to an alternate system. 

For example: An installation with two systems might normally 
run with the following mass storage configuration. 



El 

DEVICE 

ACCESS 

CON TENTS 

System A 

0 

aoa 

A 

Direct 

access files. 


1 

am-M 

A 

Master 

device. 

System B 

0 

aoa 

B 

Direct 

access files. 


1 

am-M 

B 

Master 

device. 


If System B became inoperative, access B for the fiOfi and SMl-M 
could be switched to System A. This could be done without 
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interruption to System A. Similarly if some installation had 
permanent files on disk packs {641} and that installation became 
inoperable 1 those packs could be introduced into such a system 
as System A or B. 


The following limitations exist: 

1. The equipments to be introduced must be defined at system 

configuration time and status set as not available. As in 

the example above for System An access B would have to be 

defined. The CURDECK entries might appear as:* 

E(30=DB-.0Nnl-,D-.Q. ACCESS A 

E(ai = l1D-4-.0N-.4-.0-.2. ACCESS A 

E(25=I>B-,NA-il-.D-.l.** ACCESS B 

e«;i3=iid-m-,na-.m-.0t3. access B 


Similarly for System B 

E(3 0 ~ 1) B 1 ON T1T D11. 

E(J1 = I1]>- M-.0N ■.M-.D-.3. 

E(32 = I>B-.NA-.liO-,D. 
E(33=n])-M-.NA-.M-,D-.2. 


ACCESS B 
ACCESS B 
ACCESS A 
ACCESS A 


See Operator's Guidei page S-15 for description of CMRDECK 
entries. 

NOTE: Parameter NA indicates device is not available. 
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S* Users can access permanent files within their own family- 

Access to files for users in another family is not permitted 


3- Any portion of a family may be introduced into another 
system providing that portion includes the device which 
contains user control and validation data -CVALIPUS File> • 

5|C 

This will be the master device that has device mask bit 7 
set plus whatever device the VALIDUS File resides on if 
not on the master device- If a user whose master device is 
not introduced into the alternate system tries to access 
his files on the new systemn the messages 
PERMANENT FILES NOT AVAILABLE 
will be issued for any permanent file requests made- 
Other portions may be introduced at any time after the 
introduction of the device containing VALIDUS- 


4 - If a non-master device is not introduced and a user tries 
to access files on that device the messages 
DIRECT ACCESS DEVICE ERROR 

will be issued- However-i the user will be able to access 
all indirect files- For example-i in the above configuration 
if the fl41 for System B were moved to a system that the 
fiOfl was not connected to-i the users for System B could 
access all files except those that resided on the flOfl-i 
providing the VALIDUS file resided on the 641. 

See Operator's Guide-i Chapter 6 for definition of this file- 
See definition of Device Mask in Operator's Guide-i page 7-2- 
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3»1»1 System Configuration 

A system may be configured to accommodate additional families 
of permanent file devices by specifying the correct entries 
when configuring the system* Following are descriptions of 
the CURDECK entries required for this* 

3.1* 1* 1 E(3nn=dt ist len lun ichlichS tR* 

This entry defines the equipments which can be accessed by 
the system.* 

nn = Equipment Status Table Ordinal 
dt = Device Type 

St = ON Device available for system allocation* 

= OFF Device available! but no system alloca¬ 

tion permitted* 

= NA** Device not available* This status would 

be used for devices to be introduced 
from alternate systems! or as removable 
devices * 

= IN** This specifies device is interchangeable 

and is available for access* 

en = Physical Equipment Number* 

un * Physical Unit Number* 

chl!ch2 = Channels equipment is connected to**** 

R If specified! automatic release of reservation is per¬ 
formed when channel is released. 

* See Operator's Guide! page S-IS for further description of this 
entry and full descriptions of all parameters* 

** This is only change in this entry from KRONOS 2*0* 

*** See F.RS for support of CYBER hardware enhancements* 


AA 3777 


nilMTEDINUl&A. 



CONTROL DATA CORPORATION 


DIVISION 


DOCUMENT CLASS_ 

PRODUCT NAME_ 

PRODUCT MODEL NO, 


ERS 

KRONOS 5.1 

Eoafl»a.i 


PAGE NO._H 


7 Rev A 


MACHINE ^PBiP«: bDDO/CDC CYBER 75.7 3.7M 


PFs'nmstity-idmifmdn. 
PF=nnistityifn« -Clf ty=R> 


This entry defines the permanent file characteristics of 
the equipment referenced. This entry is necessary only 
when the device is being initialized. This entry must be 
made after equipment is defined -CEfinn entry!. If the 


equipment is redefined after the PF entry has been made-i 

the PF entry must be re-entered since redefinition of an 

equipment or clearing an equipment definition •CE(3nn=0.} 

clears PF description for that device. 

nn = Equipment Status Table Ordinal 

St = ON Device is considered active PF device 

and system will attempt to recover PF 
during system recovery. Users will be 
able to access files on this device. 


= OFF 

ty = I 

= D 


= R 


Device is considered inactive for PF 
access. Users will not be able to 
access files on this device. 

Device may contain only indirect per¬ 
manent files. This must be a master 
device -Ci.e.i dm^D}. 

Device may contain direct access files. 
{This does not exclude the residence of 
indirect files* Master devices always 
contain indirect files*} 

Device is considered removable. This 
must be specified if any of the removable 
device commands are to be issued for 
this device {see Section 3.2}. Removable 
devices may contain direct and indirect 
access files. 
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NOTE: If ty=RT this indicates only that 

the device being recovered is a 
removable device. This equipment 
may be used during operation of the 
system for either removable devices 
or alternate family devices. 
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dm Device mask -Csee Section M-11 •for 

definition}• Not entered if ty=R• 

fn Family Name- This is a 1“? character 

parameter defining the permanent file 
family this device belongs to- Combined 
dm for family must be 377B- If ty=R 
then the fn parameter represents the 
pack name associated with the device- 

dn Device Number- This number {1-778} 

defines the device within a family- 
This should be a unique number within 
a family- If ty=R this parameter is 
not entered- 


NOTE: See Appendix D for method of recovery of 

permanent files between S-l systems and 
5>0 systems* 
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3.1.1.3 INITIALIZE mn me.* 

This entry will cause system to place a label on device 
nnn release all existing PF space defined and initialize 
those portions of the device required for PF access -Ci.e.T 
catalog tracks t permit tracks and indirect access tracks}. 
nn Equipment Number 

nc Number of Catalog Tracks. This is optional 

parameter which may be used to specify a number 
of catalog tracks other than the default.** If 
nn is not a master device* 

ILLEGAL ENTRY error message 

will be issued, nc must be a power of 5 -Ci.e.i 
It St M .} and maximum of SOOg. 

If nn is defined as a non removable PF deviceT then the 
parameters dm fif master device}T fn and dn are defined 
on the PF entry. If nn is a removable device fn is 
defined on the PF entry.*** 

If the E(2 entry specifies the st=NAT then no physical 
initialization will take place but initialization status 
will be maintained for this device and will take place 
whenever the device becomes available. 


* This entry is legal only as console CflRDECK entry. If contained 
in CMRDECK loaded from deadstart tape message ILLEGAL ENTRY will 
be issued. 

** The default number of catalog tracks is defined in APPENDIX B. 

If a removable device is to be initialized with any parameters 
other than pack name li.e.T if user number or password is to be 
specified} then the device must be initialized after deadstart 
via the MDI command - see Section 3.S.I.I. 
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3.1.1.M FAI1ILY=nn. 

For normal mode of operationn users at an installation do 
not have to specify the family to which they belong. How¬ 
ever! when multiple families are active in the systemi the 
user must identify his family at login or job initiation 
time {see Section 3.1.Ml. To ease user conversion to an 
alternate system! the "system default family" can be 
defined which will indicate the family which is assumed 
if none is specified by the user at job initiation or 
login. The FAMILY CMRDECK entry allows defining of this 
default. 

nn. This specifies equipment number of any active 
permanent file device in the family desired to 
be default. 

This entry must follow the Efl entry for the equipment 
indicated. 
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3*1*S System Processing 

Two steps are included in the successful recovery of a permanent 
file system* They are: 

System Configuration 
Recovery of information from devices 
Following is a brief description of what occursi the potential 
errors that can be encountered and the action that can be taken. 


3.1.2.1 System Configuration 

Before any system activity can take place-i the equipments 
must be defined. CMRDECK entries are provided for this 
purpose. Depending on the level of recovery-, the CMRDECK 
entries will be processed as follows:* 

Level 3 All CMRDECK entries ignored. Equipment de¬ 

finitions and PF definitions recovered from 

cn. 

Level E-.1- All CMRDECK entries ignored except those 

defining mass storage characteristics. 

These entries are as specified in CMRDECK. 
CMRDECK is recovered from mass storage as of 
last checkpoint. 

Level Q All CMRDECK entries processed. 

bIhen CMRDECK entries are madei in general-, they are only 

validated for correctness of format not logical content. 


* For further description of levels of recovery! refer to Operator's 
Guide! page S-7. 
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For example 1 no check is made to insure device masks -Cdml 
for all PF devices in a family equal 377B. 

The error for E(J and PF CMRDECK entries that will be 
detected and the message 
ILLEGAL ENTRY 
displayed is: 

!• PF entry specified for equipment nn where nn is not 
defined as mass storage entry. 

In this situation 1 the operator can re-enter the E(3 and 
PF entries to correct the error. 
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3.1.2-5 Mass Storage Device Recovery 

Recovery of the permanent file information from a mass 
storage device can occur in three situations: 

Deadstart 

Introduction of Interchangeable Device 

Introduction of a Removable Device 
The internal function of these three methods are similari 
howeveri the operational characteristics are somewhat 
different. 


3*1.5*5.1 Deadstart 

The level of recovery requested determines what is 
performed for recovery of permanent file devices* During 
recovery of these devices the message 
RECOVERING dtnn 

will be displayed, dt is device type and nn is equipment 
ordinal. 

Below this line two types of error messages may be 
displayed. 

TYPE 1 The message displayed is: 

* error message description RECOVERY OF DEVICE 
IMPOSSIBLE.* 

If either 60 or IGNORE is enteredi recovery of remaining 
devices will continue and this device will be initialized 
just as if CMRDECK entry INITIALIZE inn had been entered* 
Note that no PF definitions for device will be specified 
in this situation. 
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TYPE 2 The message displayed is: 

* error message description IN CMt DATA FROM LABEL IS 
USED.* 

If this message is issuedi then upon entry of GO or IGNORE•» 
the PF parameters residing on the device -Cfm dmi dni etc.> 
will be placed in CMR and processing for that device will 
continue. 

3.1.2.2.1.1 For all levels of recovery the following steps take place. 

The label for each mass storage device is read and 
verified against that specified by the E(3 definitions-i 
■Csee Section 3.1.1}. The label is not read if Efl 
entry specified st=NA. Several steps are involved 
in label verification for a device. 

1. Label must conform to standard system sector 
format.* 

I 2. Equipment type and sector limit specified in 

label must conform with that specified by system 
I configuration. -[Sector limit is function of 

Device Type parameter - i.e.-i MD-M is 6m with 
M spindles included as one logical device 
I SLn=M*MD.} 


* See APPENDIX B for description of label and system sector. 
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3. Labels on all units of multi-unit device must 
agree and sector number must verify. This is 
to insure units are mounted in proper order when 
mounting multi-unit device. 

M. If the device has been defined as an interchange¬ 
able device! the system will attempt to utilize 
those interchangeable equipments that can be 
chained. These are any devices defined as inter¬ 
changeable! single unit! and with consecutive 
physical unit numbers. For example! consider the 
following configuration: 

E(303=l1D-l!lN!b!0!M. 

E(3DS=l1I>-l!lN !b!l!M. 

EiJOb—MD—l!lN!b!S!4. 

If the system encountered a label on E(203 which 
indicated it was the first unit of a 3 unit 
device {specified in label}! the system would 
determine if other equipments were available to 
accommodate the remaining units of the logical 
device. In this configuration! equipments 3! S! 
and la would be chained so as to indicate a three 
unit device. Once this had been accomplished! 
the system would attempt to read labels on the 
remaining units just as if E(2D3 had been speci¬ 
fied as a MD-3. If the labels are good! the 
system will recover the device. If any of the 
labels fail the verification! then the units are 
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returned to their MD-1 status and E(303 is set 
with not available status in the EST. Single 
unit device or a I1D-2 could be accommodated by 
this configuration also. 

In this situation! the labels on EiSdS and E(30t 
would also be investigated to determine if the 
labels are valid. 

S. If in attempting to read the labeli a physical 
error is encountered! the following action is 
taken. 
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Type of Error 


Type of Device 


Not Ready 


Read Error * 


Label 

Verification 


Bad Label 

{Not Label Sector! 


Interchange¬ 

able 


Set Device 
Unavailable 


Advance to 
next track 
and try to 
read. 


Set Device 
Unavailable 


Set Device 
Unavailable 


Non-Inter- 

changeable 


Wait and 
retry 


Advance to 
next track 
and try to 
read. 


Issue Error 
=*:C0NfIGURATI0M 
IS IN ERROR.* 


Issue Error 
*LABEL ERROR ON 
UNIT NN.* 
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recovery of a packi device will be left as unavailable device, n will be an 
assembly time parameter in COflSDSL. 
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If the operator types GO or IGNOREt the definitions 
specified by the CMRDECK entries will be those used 
to initialize the device. 

3.1.B.S.1.5 For level 3 recovery onlyi checking of the label includes: 

1. Device mask -Cdml specified in label is verified 
against that specified by CM- 

2. Family Name -Cfnln or Packname for removable 
device•» is verified with that specified by 

cn. 

3. Device Number {dn>T is verified against that 
specified by CM. 

If any of the above conditions are not meti then the 
type 2 error: 

DEVICE DESCRIPTION ERROR IN CM-i DATA FROM LABEL 
IS USED. 

is issued. If the operator decides to proceed with 

recovery! those parameters found on the device will 

be inserted in CMR as the PF description. If device 

being recovered and CM do not agree on residence bits 

{equipment specifications for permanent filesn direct 

access files t or removable statusJn the type 2 error 

DEVICE RESIDENCE CONFLICT IN CM-. DATA FROM LABEL 
IS USED. 

is issued. If either GO or IGNORE is enteredi device 
status will be specified as that in label- 
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Also-i the following is performed. 

1. Verification of catalog track count. 

B. Verification of location of catalog tracksi permit 
information and indirect access files. 

If either of these conditions are not meti then type 
B error 

CATALOG RECOVERY ERROR IN CMn DATA FROM LABEL IS 
USED. 

is issued. If the operator decides to proceed with 
recovery! those parameters found on the device will be 
inserted in CNR as the location and description of 
catalog information. 
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3»1*2«5»1»3 For level St 1 or D recoveryi the following additional 
steps will take place. 

TRT will be read from mass storage and placed 

in CM. If error occurs in this stepi type 1 error: 

LENGTH OF DEVICES TRT BAD RECOVERY OF DEVICE 
IS IMPOSSIBLE. 

is issued. Device will be initialized. 

3.1.S.5.1.M For level 0 recovery-* when the TRT is copied from the 

mass storage device to central memoryi it will be edited 
to remove all chains that are not permanent file infor¬ 
mation. If an error occurs in this processi the type 
1 error: 

PERM. FILE LINKAGE ERROR RECOVERY OF DEVICE IS 
IMPOSSIBLE. 

is issued. If GO or IGNORE is entered-i device is 
initialized. 

Also for level 0 recovery-* direct access file interlocks 
will be cleared -Csee Section 3.1.5.2. Ml. 

After deadstart is complete-* no verification is done to 
check: 

1. dm for equipment in family = 377B. When search¬ 
ing for the users master device t the system will 
use the first device encountered which satisfies 
user's master device definition. 
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H» Duplicate device numbers within one family* Files 
defined will contain the device number specified 
with the equipment. Utility operations for a 
device number will use the first one encountered 
in searching the Mass Storage Table from the 
beginning* 

3*1.S.S*1*S Because some of the errors encountered may cause 

initialization of the devicei it is recommended that 
the P*F. CMRDECK entries describing the device be 
kept as part of the CMRDECK- If one of the errors 
that causes device initialization is encountered! 
the parameters currently residing in the MST {those 
specified by the PF entry} will be used in initial¬ 
ization of the device* 
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3.1.2»5«2 Introduction of Interchangeable Devices 

Uhen an interchangeable device is introduced into the 
system {see Section 3.1.3 for methodln the following 
steps will be performed. 


Label Verification 

Recovery and Verification of System and Allocation 

Information 

Release of Interlocks for Direct Access Files 

3.1.5.2.5.1 The system will periodically interrogate the interchange¬ 
able devices to determine the following: 

1. If the equipment is specified as not available! 
the label is read to determine if a good device 
has been mounted on the drive. This label verifi¬ 
cation is described in Section 3.1.2.2.1.1. 

2. If the equipment is specified as available in the 
system! the label will be read and verified with 
that information kept in CM. This process is the 
same as that described in Section 3.1.2.2.1.2 for 
level 3 recovery. If an error is encountered! the 
device is left in "emergency status" with all PF 
access to device prevented. 

The error messages are the same in this situation 
• with the exception of the last portion - IN Cfl! 

DATA FROM LABEL IS USER. In this situation! the 
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data from the label is not set in CM as the device 
is currently active. 


If the operator wishes to introduce a device or 
devices into the systemi the following should be 
performed: 

a. Interrogate Mass Storage Table Display to 
determine what physical drives are available. 

b. Mount device on drive and make ready. 

c. Interrogate MST display to determine if errors 
have been encountered. Any errors encountered 
in recovery of device will be issued to error 
log -Ci.e.-. TRT LENGTH ERROR-, PERM. FILE LINKAGE 
ERROR-, etc.}. 
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3.1.5.2.3 Introduction of Removable Devices 

The steps performed for introduction of a removable 
device into the system are exactly the same as those 
for an interchangeable device. 


3.1.2.5.M Clearing of Interlock Data for Direct Access Files 

For level □ recovery or whenever a devicei removable or 
interchangeable! is introduced! the interlock information 
contained in the system sector for all direct access files 
must be cleared. This must be done because files on the 
device may have been left in any of the interlocked states 
due to premature dismounting of device or deadstart of 
the system. Dayfile messages will be issued to reflect 
the direct access files recovered from the device. For 
system deadstart! the following messages will be in the 
system dayfile. For operator commands or user requests! 
the messages will be placed in the job dayfile! and 
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printed when processing is complete. 

nnnn DIRECT ACCESS FILES RECOVERED 

This will be count of files successfully 
recovered. 

nnnn DIRECT ACCESS FILES PURGED 

This will be count of files encountered 
whose system sector was not legal. This 
will not include those files purged because 
purge status was set in interlock information. 

nnnn DIRECT ACCESS FILE ERRORS 

This will be count of files whose interlock 
information specified file was in write 
access mode and last sector in system 
allocation table -CTRT} was read and found 
not to be EOI. This count should match 
number of PF ERROR messages issued. 

The following steps are performed to clear direct access 
file interlock data. 

System sector is read and verified as legal system 
sector.* If this failsi the file purge count nnnn is 
incremented! but file space is not released. 


If file interlock status reflects no activity i file is 
recovered and count is incremented. 

* See APPENDIX b' •for f'ormat of this System Sector. 
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If file interlock status reflects purge statusi the 
space is released. 

If file interlock status reflects read accessi this 
is clearedT system sector is rewritten and the file 
recovered count is incremented. 

If file interlock status reflects write accessi then 
EOI is located from TRT. This sector is read and if 
not an EOI sectori the following message is issued 
to the ERROR LOC and SYSTEM dayfiles -Cjob dayfile also 
for operator or user request}. 

PF ERROR *pfname* Htindex* 

pf name = Permanent file name as found in system 
sector. 

index = User index for file as found in system 
sector. 

The file interlocks will be cleared and the system 
sector rewritten. File error count will be incre- 
mented. The file will be left as is on the device 
for further interrogation by the user or operator, jc 


This situation could occur when a user has allocated or de¬ 
allocated space on the filei and then written a new EOI on 
fii®* If the device is physically removed lor system dead- 
started} before system has chance to checkpoint TRT to devicei 
this situation will occur. 
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If PF dump is performed on this device t this file 
should cause length error. 


If the sector read was an EOIt interlock is clearedi 
the system sector rewritten and the file recovered 
count incremented. 
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3 . 1.3 Operator Commands 

The following operator commands are available for control of 
interchangeable devices- 


3-1-3-1 (lOUNTi fN=family namen ]>N=device numbern E(3=equipment number- 
This command will initiate system verification of the 
device and introduction of those parameters necessary for 
users to access permanent files residing on the device- 
Section 3-1-2 describes the error messages that can be 
encountered as a result of this command- A message 
nOUNT REQUEST COMPLETE 

will be issued upon successful completion of the command- 
This command deals with only one logical permanent file 
device-) thus enabling portions of a permanent file family 
to be introduced with the restrictions described in 
Section 3-1 {3-1^- 

fN Family name of device being introduced- 

DN Device number of device being introduced- 

E(3 Equipment entry to be used for new device- This 
is an optional parameteri if omitted-i system will 
flash request for operator assignment- The entry 
assigned must have been previously defined at 
system configuration time and have inactive-i 
unavailable status- This status can be determined 
by the mass storage table display -Csee Appendix 
A>- See Section 3-1-1-1 and 3-1-1-2 for method 
of definition of inactive-) unavailable device- 
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3 .1 .3.5 REflOVEi FN=family namei ]>N=clevice number 

Before a device is physically removed from the system 
-Cremovable device such as Sm removed or device such as 
flQ6 switched to another system!i the operator should insure 
that users are no longer accessing the device* The REMOVE 
command will prevent any new users from accessing the devicei 
however-i users may currently be attached to files on the 
device. The operator may determine if any users are 
currently attached to files by interrogating the mass 
storage table display -Csee Appendix A for format of this 
display}. 

FN Family name of device to be removed. 

DN Device number of device to be removed. 

If device is not active in the systemi message 
DEVICE NOT AVAILABLE 
is issued and command aborted. 

If operation is completed t message 
REMOVE REQUEST COMPLETE 
will be issued. 

The device! after completion of this function-i will be 
set as inactive -Csame as PF CMRDECK entry st=0FF}-i and, 
if no active users were attached to device equipmentt 
status will be set to unavailable -Csame as E(3 CMRDECK 
entry st=NA}. If users are currently attached to files 
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on the device-I then the device will be set inactive! but 
unavailable status will not be set until last user 
has released attachment to device. The status of 
the device may also be determined from the mass 
storage table display. 


After device is removed from system■> any user access 
to that device {even if status is still available!i 
will result in either: 

PERMANENT FILES NOT AVAILABLE 
for access to a users master device i or 
DIRECT ACCESS DEVICE ERROR 
for access to direct access files on an alternate 
device. 


CAUTION : 

If device is physically removed from system before 
users have released their attached files {user count 
/ Oil two things could occur: 

1. Mass storage device status error may occur. 

2. If another pack has been mountedi accesses made 
by a previously attached user may well destroy 
information on the new pack or the user may retrieve 
information from the new device which he*is not 
necessarily priviledged to access- Mass storage 
errors are possible in this situation also- 
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3.1.M User Interface 

The user is not normally required to specify the family name 
under which his permanent files reside for requests to the 
system. Howeveri there are certain situations where the 
family name must be provided. Following is a description 
of these situations. 


3.1.M.l Time Sharing Access 

The user does not normally have to provide the family name 
upon login to the system. Howeveri if access is attempted 
to a system other than the users normal one -Csuch as a 
back up system !1 then the family name must be provided on 
the LOGIN command. The installation must notify users if 
they are to dial into an alternate system. The parameters to 
be supplied during the login process* are: 

usernumipassworifamily. 

The system will normally at login request: 

USERNUriBER: 

PASSWORD: 

If more than one family is active in the system-i the 
system will request: 

USER NUMBER: 

PASSWORD: 

FAMILY: 

♦ See Time Sharing User's Guidei page 5-1 for description of 
LOGIN procedure. 
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If the user responds with only CR for FAHILYt the system 
default {see Section 3.1.1-4> will be assumed. 

If validation file for the family specified is not available 
{see Restriction 3 Section 3.1>-i then message 
ILLEGAL LOGIN 

will be issued at the terminal. Note error messages in 
Section 3.1 - 3i 4 for permanent file requests issued on 
alternate system. This will occur for any PF request from 
the terminal including OLDn LIBt SAVEt etc. 


AA 3777 


PRINTB) IN USA 



CONTROL DATA CORPORATION 
--DIVISION 


DOCUMENT CLASS_ 

PRODUCT NAME_ 

PRODUCT MODEL NO. 


ERS 

KRONOS 5.1 

Eoaa’i‘2.1 


PAGE NO._II_ 


MACHINE SERIES 


to Q'O / CD C"'CYB E R' 73'V? 3 •, 7 4 


Batch Jobs 

Jobs submitted to the normal system require no specification 
of family name. Howeveri if the job is to have the capa¬ 
bility of running on an alternate system -Cthat has the 
originators permanent file devices introduced}! the family 
name must be supplied on an ACCOUNT card. If the user always 
supplies family name on the ACCOUNT cardn he can be assured 
that his job will be run even if his normal system is not 
available and his permanent file family had to be moved to 
an alternate system. Format of ACCOUNT card* 

A CCOUN T Tusernumipasswor!family• 
family is optional parameter. 

The error messages indicated in Section 3.1 - 3i M will be 
issued if the devices that the user attempts to access are 
not available. 

3.1.3 Remote Batch Access 

Because jobs submitted via a remote batch terminal land the 
output generated by these jobs} are identified by the user 
number used during login! a limitation exists when a user 
must use an alternate system via a remote batch terminal. 

To login on the alternate system! the user must know a 
legal user number for the default family on the system.** 

* See Batch User’s Reference Manual! page S-2 for description of 
ACCOUNT card. 

** See EXPORT/IMPORT Reference Manual! page 3-S for description of 
LOGIN procedure. 
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j Once logged ini jobs submitted from this terminal may contain 

account cards for another family -Cjust as described for 
BATCH J0BS>- Output will be returned t based on user number 
specified by LOGIN command not user number and family 
specified in job deck submitted. 

B.l.M.M System Origin Access 

It may be necessary in certain situations to alter the 
family name associated with a job. This might occur-i for 
example! when creating a VALIOUS file for an alternate 
family with no VALIOUS file that has been introduced onto 
the system. The FAMILY command is available to system 
jobs and users with system origin priviledges -Cif system 
is in DEBUG mode}. 

Format of the command is: 

FAMILYt family name 

If issued by non-system origin jobi message 
ILLEGAL CONTROL CARO 
will be issued and job aborted. 
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3-H Removable Devices 

This feature allows users to retain permanent files on devices 
other than those within the normal permanent file family* This 
might be done if the user required access to files at relatively 
infrequent intervals* The following limitations exist! 

1 * The user must insure that the device desired for access is 
mounted and active in the system before accessing files* 
Automatic request of the device specified! when file 
access is attempted! is not performed* If access to a 
device not available on the system is attempted! message 
PERflANENT FILES NOT AVAILABLE 
is issued and request is aborted* 


2* The user must be aware of the device defined size! i*e*! 
the number of units and capacity of these units! when 
creating data on the device* For example! if the user 
knows SO million characters of data are to be created on 
a device! he must specify to the installation! when re¬ 
questing device initialization! that a device capable of 
this capacity be used li-e*! flD-H}* If user exceeds this 
capacity! he will receive one of the following messages! 
depending on what caused overflow* 

SYSTEM ERROR - Eflnn TRACK LIMIT 

PFM could not allocate space on device assigned as 
equipment nn* 
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Eflnm TRACK LIfllT 

Normal system access {CIO write request! could not 
allocate space required for write on device specified. 

3.2.1 Operational Characteristics 

The installation must determine the number of equipments desired 
for removable device access when configuring system. The re¬ 
movable devices are specified by the proper equipment {E(3} and 
permanent file {PF} entries {see Section 3.1.1}. Following 
is an example of how CflRDECK entries might be set up to accom¬ 
modate M units of an SMI as removable devices. 

The equipments would be defined as four single unit devices: 

E(33=l11>-l-.NA-,S-,2-,7. 

E(3M = l1I>-l-,NA-iS-.3-,7. 

E(3S=l11>-liNAnSTMi7. 

Eflb=l1]>-l-.NA-.SiS-,7. 

Note the physical unit numbers are consecutive. This is to 
allow mounting of a four unit device. The unit numbers need 
be consecutive only to the limit of the largest size {number 
of units! device to be accommodated. Device types may not be 
mixedi i.e.i an equipment may not be defined as an MD-l and 
then successfully mount DD-1 as this equipment. 

During deadstart a removable device will be recovered like 
any other mass storage device. If the label indicates this 
is a removable device t then it will be specified as such 
during system operation. 

I 
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3.5.1.1 DDI - Hass Storage Device Initialization 

UDI is called to a control point to perforin various initial¬ 
ization functions for mass storage devices. These functions 
include: 

1. Definition-I labeling and initialization of any type of 
mass storage devicei 

2. The ability to flaw mass storage devices on-line-i and 

3. The ability to format -Cwrite headers on> an fiMM disk 
pack. 

3.2.1.1.1 HDI may be initiated directly through the following call: 

l1DlTE(3=nn. 

- where nn is the EST ordinal of the device to be 
initialized. 

No further operator intervention is required if the device 
to be initialized is a removable device. To initialize 
all other device typesi the initialize status must first 
be set in the MST {see Appendix B-fli word PFIL>. 

HDI may also be initiated with the following call: 

HDI. 

Through this calli all parameters must be entered via 
the K-display.* This method enables the operator to 
change the device description associated with the devicei 
when it is initialized. Once all parameters have been 

* For K-display operations! see Operator's Guide-i pages 7-1 and 7-2. 
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entered 1 the operator must enter 60. and then initialization 
proceeds* -CSee Appendix E for example of the K-display.> 


For both types of calls t the initialization process proceeds 
automatically for removable devices* Howevern for all other 
mass storage device typesi the initialize status must first 
be set in the MST -Csee Appendix B-St word PFIL>* 


3*2*1*1*S Any of the following parameters may be entered via the 
K-display. 

FN 1-7 character family name. This is the family 
that this device will be initialized to be part 
of* 

PN 1-7 character pack name. This is the name by 
which this unit or group of units will be 
referred to whenever access to or operations 
on it are desired* 

UN 1-7 character user number* This parameter can 
only be entered in conjunction with PN* If 
specified! this device is considered a private 
device and only this user will be allowed to 
place files on the device {perform SAVEi 
REPLACE! or DEFINE requests}. 

PU 1-7 character password. This parameter provides 
a level of security for a removable device. If 
this parameter is specified when the device is 
defined! then it must be specified whenever the 
device is mounted by any one but the operator 
{console MOUNT request}! user with system 
priviledges {system in DEBUG mode}! or owner 
if the device is private. 

DM Three octal digit device mask. This parameter 
is required whenever a master permanent file 
device is being initialized. It defines which 
users have this device as their master device* 

NC Octal number of catalog tracks {power of two}* 
Optional parameter which may be used to specify 
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a number of catalog tracks other than the 
default.* If UN is specified -Cprivate deviceli 
then this parameter is illegal since only one 
catalog track will be allocated. The maximum 
value is 5DDg* 

Ei3 EST ordinal of device. This is the first 

equipment number of device to be initialized. 

For multi-unit devices t this must be the first 
of NU consecutive units. 

NU Number of physical units that the device is to 
be defined for. Default is 1. 

DN Logical device number that will uniquely identify 

the device within the system. 

PU Physical unit number of SHM pack to be formatted. 

OP Initialize option. 

0 = Full initialize -Csee Section 3.S.3.3}. 

1 = Initialize and recover flaws -Csee Section 

3.2.3.m. 

2 = Enter flaws -Csee Section 3.2.3.S>. 

3 = Format pack -CflMM} -Csee Section 3.2.3.b}. 

For a description of the RTKt TTK-i and STK parameters for 
flawing a device-i refer to Section 3.2.1.1.5. 


3.2.1*1.3 Full Initialize 

For initializing a system permanent file device-i the FNi 
Dfl-i NC -1 E(3i and DN parameters are inspected and the device 
is initialized accordingly. The full initialize clears 
all previous permanent file definition on the device. The 
device is then definedi labeled-i and initialized as 
directed by the inputted parameters. 


* The default number of catalog tracks is defined in Appendix B. 
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For initializing a removable devicei the PNt UNi Ptili Efln 
NC-i and NU parameters are used to define t label and 
initialize the device. This is the only method available 
to define a device as a private device or a public device 
with a password specified. All units of the device must 
be mounted to perform this process, (lass storage errors* 
will be issued for any unit not mounted. The operator 
should physically label all units for a device since it 
is necessary to have them in proper order when mounting. 

If E(3 is specifiedn the device must be inactive! with no 
active users attached to files on the device {see mass 
storage display Appendix A to determine this} to perform 
this function. If E(3 is not specified! then the system 
will search for the removable device described and! then 
if located with no active users! labeling will take place. 

This command will also cause initialization of a device! 
as described in Section 3.1.1.3! which causes all permanent 
file information to be released and catalog tracks and 
permit file initialized. 

3.5.1.l.M Initialize and Recover Flaws 

This type of initialization is identical to that which is 
described in Section 3.5.1.1.3 with the following exception. 

* Refer to Operator’s Guide! page B-5 for description of these errors. 
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An attempt is made to recover a TRT from the device. If 
this is successful! all flaws indicated in the TRT are 
retained when initializing the device. 


3.2.1.1.S Flaw Device 

This option permits on-line flawing of a mass storage 
device. The parameters for doing this are constructed 
similar to those entered as CMRDECK entries for flawing 
a device at deadstart time. The Efl entry must be entered 
before any of the flaw entries in order that a device 
type is designated. This is needed to determine the 
algorithm to be used in interpreting the flaw entries. 

A maximum of BOg flaw entries may be entered for each 

MDI call. 


Three types of flaw entries are provided: 

RTK This takes the inputted physical address! 

converts it to a logical address and indicates 
in the TRT that this track is a reserved! 
flawed track. 

TTK Input is same as RTK! however! reservation is 
toggled. If the track was previously not 
reserved! then! this command produces the 
same results as an RTK. If the track was 
previously reserved as a flawed track! then! 
that reservation is removed. 

STK This takes the inputted logical address {no 
conversion required! and proceeds as an RTK. 
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For all flaw entries! if the indicated track is already 
reserved by the system {but not as a flawed track! an 
error status is returned. 
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Format Pack 

This option provides the means of formatting -Cwritting 
headers on! an SMM disk pack on-line. Only one unit can 
be formatted per UDI call. This option requires entry 
of the E(3 and PU parameters. Once formatted! the unit 
is also initialized according to any entered parameters. 
Initialization takes place according to the same rules 
applied to the CMRDECK entry INITIALIZE fsee Section 
3.1. Ii. 31» ^ 


* For further description of Formati refer to the 7DSM/fiMM ERS. 
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3«2»1«<2 MOUNTPi PN=packnamei UN=user numberi E(3=equipmenti NP=np 

This command is processed the same as the MOUNT request for 
interchangeable devices {Section 3.1.3.1}. Refer to Section 
3.1.2.2.2 for processing that is performed and-i when family 
name is referencedn^in these-descriptions use packname 
■CPN parameter} and^ when device number is referencedt Use user 
number -CUN parameter}. For the removable device mount commandn 
MOUNTP-i the unit count must be supplied to allow system to 
check for available units. If equipment is assigned which 
does not have the number of consecutive units available 
that is required -CNP parameter}! the message 
ILLEGAL DEVICE ASSIGNMENT 

is issued! device released and another equipment assignment 
requested. If mount request is successful! all units asso¬ 
ciated with device will be specified as such in mass storage 
tables! so operator can determine what units are assigned 
to which packs by interrogating mass storage table display. 

{See Appendix A.} 

Other error messages encountered are: 

EflUIPMENT DEFINITION CONFLICT 
DEVICE ACTIVE 

Further description of error message is in Appendix C. 
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3<S«1«3 REH0VEP-I PN=packnamei UN=user number 

This command is processed the same as the REMOVE request 
for interchangeable devices {Section 3.1.3.21. The error 
messages are the same and the processing performed the same 
with the exception that the family name parameter is replaced 
with packname and device number replaced with user numberi 
if specified. If UN is not specified! device with PN = 
packname and UN=D will be removed* 


Error messages encountered are: 

DEVICE NOT AVAILABLE 

See Appendix C for further description of this message. 


3.2.l.M M0VE-.eql!eq2 

This command enables operator to switch the physical units 
numbers for two packs to make units available for multi 
unit devices. 

eql Equipment ordinal to be switched. 
eq2 Equipment ordinal to be switched. 

NOTE: Operator should be careful to insure units being 

switched are for equipments specified on this command. 
Refer to mass storage display to determine proper 
units {Appendix A}. 

After command is issuedi flashing message will appear at 
control point: 

SWITCH - MD-.CHn-.Ei2m!UNn-CHn-,E(am-,UNn 

where n can be any two digit number! and m can be any one 
digit number. 
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Operator should verify that the equipments involved are 
those desired and if not correctn enter n«DR0P and reissue 
command • If correct-i operator should idle system to insure 
no access is currently taking place on devices* After 
system is idle and physical units or packs have been 
switched*! operator should enter n*G0* and when this opera¬ 
tion is complete*! AUTO to allow system to continue 
operation * 

If eql or eq5 is not currently specified as single unit 
devices in equipment definition*! message 
ILLEGAL DEVICE ASSIGNMENT 

is issued and command is aborted* This would occur for 
example! if either eql or eqS were one unit of a currently 
mounted and active multi unit device* 

The following example illustrates a typical example of the 
use of the MOVE command based on the removable device con¬ 
figuration described in the beginning of Section 3.E*1* 

1* User A requests mounting of removable device A which 
contains 5 units* Since all removable equipments are 
available-! the operator assigns equipment 3* This now 
makes equipment 3 and equipment M occupied-i since it is 
a 5 unit device* 
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2. User B requests mounting of removable device B which 

contains 1 unit* The operator assigns the next available 
uniti equipment S- The status of the r^ovable-devices 
is now: 

Logical - eq3 eqM eqS eqb 

Physical- Unit S Unit 3 Unit M Unit S 

Pack - A-1 A-5 B-1 -CUnusedl 

3* User A completes access to device A and issues remove 
command. This leaves only equipment S {Unit Ml active. 

M. User C now requests mounting of device C which contains 3 
units. Since 3 consecutive units are not availablei but 
3 units are free-i operator must move device B to make 3 
consecutive units available. The operator issues command 
MOVE Sib. 

and message displayed is 

SWITCH - HI>iCH7iE(3SiUM - CH7iE(3SiUS. 

At this point the operator should idle system. After 
switching physical units or' packsi operator enters h-GO to 
control point flashing switch request and then AUTO to 
resume system operation. 

Operator can now assign equipment B to user C’s mount 
request. The status of the removable devicesi after 
completion of mount requesti is: 
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Logical - eq3 eqM eqS eqli 

Physical - Unit 5 Unit 3 Unit S Unit M 

Pack - C-1 C-2 B-1 C-3 


3.2.1.S PF Utilities* 

The normal permanent file utilities may be used on a remov¬ 
able device by performing the following: 
where the FN parameter is required 
supply the packname* 

All the options available for normal PF devices are avail¬ 
able for removable devices* All units of a removable 
device must be mounted and available to perform utility 
operations on them* 

3*2*1*b User Control 

User access to removable devices and the use of removable 
device commands - REMOVEPnllOUNTP etc* can be controlled by 
the user validation controls* A bit set in the access 
word •CAIil=CSRP>** specifies the user's priviledges to issue 
control commands -CnOUNTPnREriOVEP} and create files on remov¬ 
able devices* If attempt is made to issue either of these 
commands or a PF allocation command ISAVEnREPLACE or DEFINE! 
without this access priviledgen message ILLEGAL USER ACCESS 
is issued* 

* See PFM and Utilities Enhancement ERS for full description of 
parameters * 

** See Operator's Guide-i page fl-7 for description of Access word* 
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3 . 5 *2 User Interface 

Three control cardsi and macrosi ex.Tst to enable the user to 
access permanent files on a removable device- Additional 
parameters have been added to all permanent file commands and 
macros to specify access to a removable device- The following 
procedure is used by the system to determine what device to 
access for a permanent file request- 

1- Use packname parameter if specified on PF request- 

2- If no packname specified on PF requesti use packname 
specified in control point area €set by PACKNAfl command - 
see Section 3-2-2-31- 

3- If no packname specified on requestn or in control point 
area-i access user’s normal master device- 


In addition-i the following user restrictions exist- 

Any direct access files defined for a removable device must 
reside on that removable device- A user can insure this by 
issuing a DEFINE command using the PN parameter before creat¬ 
ing the file - 

The user must have validation permission to create or replace a 
file on a removable device or issue any of the removable device 
commands IflOUNTPnREMOVEPl - * If this validation priviledge is 


* See Time Sharing User’s Cuiden Chapter S for PF commands available- 
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not seti the message 

ILLEGAL USER ACCESS 
is issued and the request is aborted. 

The device manipulation commands REMOVEP and MOUNTP are 
available only in the BATCH subsystem for time sharing 
users - if the validation priviledge has been given* The 
PACKNAM command and the PN parameter on PF commands are 
accepted in any subsystemn just as other PF commands are.* 

3.S.S.1 MOUNTPi PN=packname-i UN=user number-i Pli)=passwordT NP=units 
This command is processed exactly the same as the MOUNTP 
operator command -[Section 3.S.]i*5> with the following 
exceptions. 

1. User may not specify equipment number. Operator must 
assign equipment. 

B. If device specified is private device -CUN^O}-! the user 
requesting mount -Cunless user has user number same as 
user number of device-i which is kept in device label} 
must supply password specified in label of device. If 
proper password is not specified-i message 
DEVICE LABEL ERROR 

will be issued and job will be terminated. The password 
will'not be checked for system origin users or users 
with system origin priviledges -Cif system is DEBUG mode}. 

* See Time Sharing User’s Guide-i Chapter S for PF commands available. 
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3. When device is available or if currently available-! the 
message: 

MOUNT REQUEST COMPLETE 
is issued to job dayfile. 

M. Messages specified for operator MOUNTP command are 

issued at console for operatori for user MOUNTP requests. 

S. Note: User must supply number of units required for de¬ 
vice specified. Operator will mount devices specified 
and assign the appropriate equipment -Cn.ASSIGN -Cnnll. 

If the number of units available does not match the 
number specified-i the request will be aborted after 
issuing message: 

DEVICE LABEL ERROR UNIT nn 

The request will also be aborted if label verification 
-Csee Section 3.1.5.5.1.1} failsi the same message will 
be returned. 
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REMOVEP-i PN=packnameT UN=user number 

This command is processed exactly the same as the REHOVEP 
operator command {Section 3.2«1*3> with the following 
exceptions* 

1* If the device is private {UN^dli only the originating 
user number {owner of device} may remove it* Any 
other user request for removal of private devices will 
result in message 

DEVICE NOT AVAILABLE 

and the command aborted* Other users may remove the 
private device only if they have system origin privi- 
ledges {and SYSTEM in DEBUG mode}* In this situatiom 
user must supply UN parameter. Owner of device does 
not have to supply UN parameter. Operator may also 
remove device by specifying both PN and UN. 

3.2*2.3 PACKNAM {PN=packname} 

Set default packname. This command causes all subsequent 
permanent file requests to go to the removable device 
specified. This eliminates the need for the PN parameter 
on the PF requests. 

PN 1-7 character packname. If packname already set 
for job this will replace it. If PN=dT current 
default packname is clearedi thus causing PF re¬ 
quests to access normal master device {unless PN 
parameter specified in request}. 
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3«S*S>M Commands 

All PF commands have additional parameter -CPNl which can 
be specified. This will cause PF request to access device 
specified. If the device is not available in the system-i 
message 

PERMANENT FILES NOT AVAILABLE 

will be issued and request aborted. Following is a list of 
the proper PF request formats showing the PN parameter.* 

For all commands where defaults are not otherwise specified! 
the following hold: 
pw = null 
un = null 
pn = null 


* Refer to Batch User’s Reference Manuali page S-Sl for further 
description of PF commands. 
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APPEND -CpiplipHipaT .. Tpi/pwiumpn> 

APPEND FILES pi*..pi to permanent file. 

Each file 5Kpi» is appended at EOI of *p* 

p = permanent file to be appended to. 

pi = files to be appended. 

pw = file password. 

un = optional user number. 

pn = pack name. 


I ATTACH •Cf=p/umpwTmTpnTa> 

ATTACH permanent file for direct access usage 
f = working file name 
p = permanent file name 
un = optional user number 
pw = file password 
m = mode of access 

R - READ = Read only access 

111 - lilRITE = Write or read access 

E - EXECUTE = Execute only access. 

II - MODIFY = Modify or extend 
A - APPEND = Append or extend file 
RM - READMD = Read and allow modify 
RA - READAP = Read and allow append 

I a = abort if file is busy otherwise job is suspended* 

pn = pack name. 

Default Values. 

m = Read. 


DEFINE {f=p/pwictirimipmsl 

DEFINE permanent file for direct access usage, 
f = working file name, 
p = permanent file name, 
pw = file password, 
ct = file category. 

r = device type file is to be assigned to 
m = mode of access allowed for semi-private or library 
pn = pack name, 
s = space desired for file. 


* See User Profile Control ERS. 
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Values* 

= private. 

= D -Cuses device with most space or device file 
currently resides onl. 

= write. 

= D 

GET •Cf=p/pwiun ipn> 

Retrieve copy of permanent file for system usage. 

Indirect access files only, 
f = working file name, 
p = permanent file name 
pw = file password 
un = optional user number, 
pn = pack name. 

PERMIT IfTunl=mliunS=mai...Tunn=mn/pn> 

PERMIT user to access permanent file with specified mode, 
f = permanent file name, 
un = user number to be permitted, 
m = mode of access permitted. 

U - WRITE-, READ-, EXECUTE APPEND 
R - READ-, EXECUTE. 

E - EXECUTE 
A - APPEND. 

N - NULL. 

M - MODIFY. 

RM - READ ALLOW MODIFICATION 
RA - READ ALLOW APPEND 
pn = pack name. 

Default Values, 
m = READ. 


Default 

ct 


m 


PURGE -Cp/un-,pw-,pn> 

PURGE permanent file 

p = permanent file name, 
un = optional user number. 

•Cuser must have write permission} 
pw = file password 
pn = pack name. 
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REPLACE -Cf=p/pwiunipn> 

REPLACE permanent file with copy of working file. 

Indirect access files only, 
f = working file name, 
p = permanent file name 
pw = file password 
un = optional user number 

{user must have write permission!, 
pn = pack name. 


SAVE {f=p/pwictimipn! 

SAVE copy of working file on permanent files. 
Indirect access files only, 
f = working file name, 
p = permanent file name, 
pw = file password 
ct = file category 
m = mode of access 
pn = pack name. 

Default Values. 

ct = private, 
m = write. 


CHANCE {f=p/pwict-imipn! 

CHANCE parameters of permanent file, 
f = new file name 

p = old file name 

pw = new password 
ct = new file category 

m = new file mode 

pn = pack name file resides on 


If p not specified-* name is not changed 
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3.2-H-S Macros 

All PF macros have additional parameter specifying packname.* 
In addition n macros for MOUNTP-i REMOVEP and PACKNAM are 
available. Following is the format of each of the macros 
available■ 


PERPANENT FILE ACTION MACROS. 

THE FOLLOWING INFORMATION APPLIES TO ALL PERMANENT 
FILE ACTION MACROS. 

COCE CAN BE CPTIMIZEC BT PASSING ARGUMENTS VIA REGISTERS 
INCICATEC CN THE FOLLOWING PARAMETERS. 

THE FET LENGTH MAY BE- 

A. 5 WCPOS IF NO SPECIAL OPTIONS ARE REGUIRED. 

B. LP TO 13 WORDS IF ANY SPECIAL OPTIONS ARE REQUIREC. 

IF ♦pf* IS NOT SPECIFIED. (Ff8) CONTAINS PERMANENT 
FILE NAME. (XI) 

IP »un* IS NCT SPECIFIED, (FfR) CONTAINS NAME OF 
ALTERNATE CATALOG.(X3) 

IF •pw* IS NCT SPECIFIED, (FflO) CONTAINS THE 

PTi p Pfl^<;wrcr 

IF *uc* IS NCT SPECIFIED, (F^-ll) CONTAINS USER 
CONTROL INFORMATION. BIT MUST BE SET IF THIS WCRD 
CONTAINS DATA FOR *PFM» TO PROCESS. 

IF «pri* IS NCT SPECIFIED, (FH2) CONTAINS ALTERNATE PACKNAME 
TO SATISFY FF REGUESTS FROM. 

THE ADDRESS CF THE FET MUST BE SUPPLIED VIA ♦F* PARAMETER. 

THE CALL MACE TO ♦PPM* WILL RECALL THE CPU WHEN THE REQUEST 
IS COMPLETE. IF THE USER CESIRES TO PROCESS *PFM* ERRORS 
THE ERROR PROCESSING BIT MUST BE SET IN THE EET. 

THE ERROR CCDES WILL BE RETURNED IN THE CODE AND STATUS 
POSITION OF THE FET (WORD 0, BITS 9-17). SEE PFM 
DOCLMENTATICN FOR ERROR COGES AND DESCRIPTIONS. 

USES X - 1,2,3,4,6,7. 

B - 2. 

A - 1,2,3,4,6,7. 


Refer toBatch User's Reference Manualn page 7”7 for use of 
PF macros. 
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PERHIT IfnpflUnimf-ipnl 

f = JCDRESS OF FET. 
pf = PERMANENT FILE NAME, 
un = USER NUMBER TO PERMIT 
m = MODE OF ACCESS PERMITTED 
pn = pack name• 


PURGE -Cfnunnpwnpnl 

f = ADDRESS OF FET (PERMANENT FILE NAME) 
un = OPTIONAL USER NUMBER 
pw = file PASSWORD 
pn = PACKNAME 


REPLACE {fipfTumpwiucTpnl 

f = ADDRESS OF FET. (WORKING FILE NAME) 

pf = PERMANENT FILE NAME 

un = OPTIONAL USER NUMBER 

pw = FILE PASSWORD 

uc = USER CONTROL WORD 

pn = PACKNAME 


SAVE If Tpf Tpw-iucictimnpn} 

f = ADDRESS OF FET.(WORKING FILE NAME) 
s PERMANENT FILE NAME 

pw = filr password 

uc = USER CONTROL WORD 
ct = FILE CATEGORY 
m = FILE MODE 
on = PACKNAME 
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CHANGE {fipfinfTpw->ucictifTiipn} 


f = ADDRESS OF FET. COLD PERMANENT FILE NAME} 
pf = OLD PERMANENT FILE NAME 
nf = NEIi) PERMANENT FILE NAME 

pw = NEW PASSWORD {Ma/?777...i la/D IF NO CHANGE} 
uc = USER CONTROL INFORMATION 
ct = NEU FILE CATEGORY 
m = NEli) FILE MODE 
pn = PACKNAME 
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APPEND Ifipflumpwipn} 

f = ADDRESS OF FET. {CONTAINS FILE TO BE APPENDED} 
pf = PERMANENT FILE TO BE APPENDED TO- 
un = OPTIONAL USER NUMBER 
pw = FILE PASSWORD 
pn = PACKNAME 


ATTACH -CpnpfTunipwitnipn} 

f = ADDRESS OF FET. -CUORKING FILE NAME} 

pf = PERMANENT FILE NAME 

un = OPTIONAL USER NUMBER 

pw = FILE PASSWORD 

m = MODE OF ACCESS DESIRED 

pn = PACKNAME 


DEFINE -Cf ipf ipwiMCndict itnipn ts} 

f = ADDRESS OF FET. {WORKING FILE NAME} 

pf = PERMANENT FILE NAME. 

pw = FILE PASSWORD. 

uc = USER CONTROL WORD. 

ct = FILE CATEGORY. 

m = MODE OF ACCESS ALLOWED TO FILE. 

d = DEVICE TYPE. 

pn = PACKNAME 

s = SPACE DESIRED. 

USES X - l-,5-.3-.M-.S-.b-.7. 

B - B. 

A “ 1 t 5 131 4151 b 17* 


GET {fipfnunipwnpn} 

f = ADDRESS OF FET. {WORKING FILE NAME} 
pf = PERMANENT FILE NAME, 
un = OPTIONAL USER NUMBER, 
pw = FILE PASSWORD, 
pn = PACKNAME 
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M.O DEFINITIONS 

The following terms are defined to fully understand the scope 
of this project* 


M*1 Account Number {User Number! 

The account number is a 7 character alphanumeric quantity which 
is assigned to a user for identification in the system. This 
parameter also defines a unique permanent file catalog area 
which contains a directory of all of the users permanent files. 
A password is optional with the account number. 

M.2 User Index 

The user index is a 17 bit quantity which is uniquely defined 
by the account number. The two parameters! account number 
and user indexn are kept with other critical Job parameters 
for the duration of a job or terminal session* The user index 
is used to uniquely describe the logical devicei the catalog 
track on the device and the entries within the catalog track 
which belong to the user.* The user index is kept in every 
permanent file catalog entry. 


*For method of determining device and catalog track from user 
index! refer to Operator's Guide - Chapter VII publication 
number STlSlbODi Rev. B. 
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M.3 Validation File 

The Validation File is a three level structured file which con¬ 
tains all account numbers t user indexes and control information 
for the account numbers. This file is accessed whenever a user 
issues an account and/or attempts to login from a terminal. The 
control information describes the type of priviledges the user 
has during operation on the system. It also places certain controls 
on the resources the user may utilize at any particular time.* 


M.M Master Device 

The Master Device is that device which contains all the permanent 
file catalog entries and indirect access files for a specific 
user. The user's masters device must be available on the running 
system if permanent file access is required unless all access is 
to a removable device* The User Index and Family Name -Csee Section 
M.15> uniquely describe a users Master Device. The only other 
area where a user may have catalog entries is on a removable 
device {see Section M.mii in which case the user must specify 
the packname {PN>. as part of each permanent file request- Each 
master device is organized into S logical sections. 

1. Allocation Information 

2. Catalog Information 

3. Permit Information 

M. Indirect Access Files 
S. Direct Access Files 

* Refer to User Profile Control ERS for further definition of this 
file. Also refer to Chapter VIII of Operator's Guide. 
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M.S Hasten Device Allocation Information 

The allocation area for a master device contains: 

1. The Device Label - This contains information describing the 
device! such as family namen user maskn and the Location of 
Permit Information! Catalog Information! and Indirect Access 
Files. 

2. The Track Reservation Table -CTRTI is the key to allocating 
information on this device and to describing the physical 
layout of data on the device. 


Catalogs 

The catalogs for a master device are allocated in such a way as 
to contain catalog entries for a specific group of user indices. 

A particular catalog track may contain entries for many users! 
the number depending on the number of catalog tracks defined for 
the device Csee Appendix B>. The user index provides the mechanism 
for differentiating between users files on a particular catalog 
track. 


M.V Permit Information 

Every user has the capability of allowing other users to access 
his permanent files. This can be done by implicitly or explicitly 
permitting the user to access a particular file. Information 
describing the permission for all files on a master device is 
contained in the permit file. Catalog entries contain a relative 
sector address within this permit file for permissions that have 
been granted for the file. 
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Indirect Access Files 

The master device for a user contains all his indirect access 
files. These files can be accessed by commands which generate 
working copies for manipulation by the user.* These files are 
allocated on the master device on a PRU -CbM Cfl words! basis. 

M.T Direct Access Files 

Direct access files are files which can be accessed in place. 

A working copy is not generated so any updates or alterations 
made to the file are permanent when made.** A direct access 
file may reside on the master device or any other device within 
the family -Csee M.lBl that allows residence of this type of 
files. Permanent file devices not specified as master devices 
contain only direct access files land possibly system information! 
scratch files t rollout filesi etc.!. The capability to interlock 
direct access filesi thus preventing or controlling access by 
other users is available to the user. 

4.10 Hass Storage Table 

The Mass Storage Table is a CflR table used to define the 
configuration of mass storage devices currently available to 
system users. One entry exists for each logical device con~ 
taining the following information -Csee Appendix A for format 
of display of this table!: 

* See Batch User's Reference Manual for description of indirect 
access file commands - publication number STlSObOD-i Rev. B. 

»* See Batch User's Reference Manual for description of Direct 
Access Commands - publication number STlSObOD-) Rev. B. 
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Device Status 
Number of current users 
Number of catalog tracks 
Device mask 

Location of start of permission data 
Location of start of catalog tracks 
Location of start of Indirect Access Files 
Interlock Status 
Family Name -Cor Pack Name} 

Device Numbers 

User Number for Private Removable Device 
Available Space on Device 
Logical Description of Device 

M.ll Device Nask 

The device mask for a permanent file device defines the groups 
of users whose catalogs reside on the device for a particular 
family. The device mask consists of 6 bits- If a bit position 
is set in the device mask-i then all user indices ending in that 
number have catalogs on the device. 


Example 

For a device mask of the following users catalogs would 

reside on the device: 

2blg = IDllOODlg 
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Bit positions 0i Mi Si 7 are set so user indices ending 
in 0i Ml Si or 7 will have the device as master device. 


NOTE: Master Devices have device masks ^ □ 

Non“Master Devices have device masks = D-. 

Removable Devices have device masks = Q. 

Since every user has only one master devicei the device 

masks for a Family must total 377B. 

Example 
UMj^ = 2bl 
UMg = llbg 

Total UM for both devices = 

M.15 Family Name 

The permanent file devices available to a user are described 
by a unique 7 character Family Name. A family may consist of 
l-b3 logical devicesi howeveri the master devices within the 
family must have user masks totaling 377B. Normally a system 
would be run with one family of permanent file devices avail¬ 
able. Additional families can be activated on a system thus 
providing the ability for users associated with these additional 
families 1 to access their permanent files via an alternate 
system. This might be helpful if a system were to supply 
backup service to another system. 


AA 3777 


mNTGDMUSA. 



CONTROL DATA CORPORATION 


DIVISION 


DOCUMENT CLASS_ 

PRODUCT NAME_ KRONOS 5 -1 

PRODUCT MODEL NO. —£QM=!L2LsJL_ 


PAGE NO. ^ 


MACHINE SERIES 


mJTJTTFr’TYHETr-THT? 3-17 M 


M*13 Device Number 

The Device Number uniquely describes a device within a family* 

It is a (a bit quantity that is assigned when the device is 
defined• All permanent files that exist on devices other than 
the master device {where the catalog entry resides! will have 
a device number in the catalog entry which indicates what 
alternate device within the family contains the file• Removable 
devices will not have device numbers • 

M*m Removable Device 

A removable device is defined as a mass storage device which 
can be logically removed from the system and replaced with 
another removable device and which is intended as an auxilliary 
PF device to the users normal PF device* Files on removable 
devices are accessed by PF commands specifying the PN parameter* 
User has the ability to schedule the use of removdDle devices* 

M*1S Pack Name 

The Pack Name for a device specifies the unique 7 character 
name associated with a removable device* The packname for a 
removable device has no family name associated with it* A 
removable device is a self contained permanent file device^ 
i*e*i all files represented by the catalogs on the device 
reside on the device* lilhen a user desires to access a file 
from a removable device the packname must be specified as part 
of the request * The normal algorithm for determining catalog 
location ■Ci*e**i user mask and family name! will be ignored 
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in lieu of the packname* Any user who knows the packname 
may access files on a removable device' 

M'lb Public Removable Device 

A public removable device is one which has no user number 
specified with it- This device can be "mounted" or "removed" 
by anyone knowing the packname land password if specified! and 
having validation priviledges to do so* Any user may place 
files on a public device {provided validation controls allow}- 


M'17 Private Removable Device 

A removable device may be defined as a private removable device 
when original definition of the device is performed- A private 
device has a unique packname and user number associated with 
it- Only the user specified may place files on this device-t 
but other users may access files as permitted by the owner 
{permit information resides on removable device!- A private 
device has only one catalog track since only one user has-files 
on the device- Because the packname and user number uniquely 
define the location of the catalogs for a private devicei it 
may be accessed via any system regardless of validation file 
compatibility- The only limitation being the user number of 
the private device must be defined to allow the user access 
to the system- 
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Interchangeable Device 

An interchangeable device is defined as any device which may 
be introduced or removed during system operation* An inter¬ 
changeable device will contain only permanent files* No 
system scratch files will reside on an interchangeable device* 

A removable device is a special type of an interchangeable 
device* 

M.n Multi-Spindle File 

The mechanisms are available to accommodate a file larger than 
one physical unit for devices defined as physically removable** 

Up to fl spindles can be included in the logical definition 
of one pack* The number of spindles desired for a device 
must be defined when the device is originally defined* When¬ 
ever the device is accessed all spindles must be available for 
access* 


* am-i fiMM-. &5H 
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APPENDIX A 
nST DISPLAY 


The E display will display one of three categories of equipments 
depending on the parameters* 

E or E-iA. 

Will display the EST entry as it currently exists in KRONOS 5*0** 
E-i n. 

Uill display detailed status of all mass storage devices* 

En T* 

Uill display detailed status of all magnetic tape devices* 


These displays can be indexed if display overflows the screen by 
entering + or - for left screen and -Cor} for right screen* 


Operator's Cuide-. page a-13 for layout of this display* 
** See ERS on magnetic tapes for layout of this display* 
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riST DISPLAY 

E-,11. 


MASS STORAGE 

TABLES 

. INDEX = 




NO. 

STATUS 

BITS 

CATALOGS 

USERS 

HOLES 

DN 

0. 

FY 

- S 
NAME= 


10. 

MASK= 

• 

0. 

0. 

li • 

FY 

- S 
NAME= 


10. 

MASK= 

■ 

0. 

0. 

a. 

FY 

- P 
NAME= 

D 

ao. 

MASK= las. 

L. 

0. 

MO. 

3. 

FY 

- PO 
NAME= 


ao. 

MASK= asa. 

m. 

0. 

m. 

M. 

PK 

-ESPOCFDINRTA 
NAME= PACKNAM 

10. 

MASK = 

a. 

0UNER= 

0. 

USERNUM 

Ma. 

■ 


Uhere 


Indicates 


INDEX 

NO. 

CATALOGS 

USERS 

HOLES 

DN 

FY NAME 
PK NAME 
MASK 
OUNER 

STATUS BITS 
E 
S 
P 
0 
c 

F 

D 

I 

N 

R 

T 

A 


Number of equipment that is first on that page. 
Logical equipment number. 

Actual catalog tracks. 

User count. 

Available PF holes. 

Device number. 

Family name. 

Pack name if removable device. 

Device mask. 

User number of private pack. 

Release reserve with channel for device. 

System on device. 

Permanent files on device. 

Catalog track overflow. 

Check point pending. 

Format request pending -CflMm. 

Direct access files on device. 

Initialize request pending. 

Permanent file access not available. 

Removable device. 

Total permanent file interlock on device. 
Alternate system device. 
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APPENDIX B 
SYSTEM INFORMATION 

This appendix will define some of the internal characteristics of 
the system in the area of permanent files and removable devices» 

1-0 Catalog Track Allocation 

Catalog tracks are assigned for a device depending on the 
type of device or as specified on the initialization command* 
-CSee Section 3*l-l-3 and 3-2*l*l>* This number must always 
be a power of 2 Ci-e-i li Sn up through SDOg- 

The default number of catalog tracks isi 

Type of Device Default Number of 

Catalog Tracks 


DA 

bboa 

10 

DB 

bb3a 

ID 

DC 

ah3 

2 

DD 

asM 

M 

DE 

ECS 

2 

DP 

am 

100 

DH 

aai 

100 

DI 

aMM 

20 

DP 

DDP path to ECS 

2 

MD 

am 

20 

Private Device 

1 
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2»D Standard System Sector Format 

Every file residing on mass storage is preceeded by a PRU 
designated as the system sector for that file. Depending on the 
type of file the information in this sector will vary. For all 
system sectors however t the following holds true: 

SYSTEM SECTOR 



FNSS = FNT entry 

E£2SS = logical equipment number 

FTSS = logical track 
Tags are defined in PPCOM. 


FASS = FST address 

DTSS = packed date and time 
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3*0 Device Label Format 

On every mass storage device a label is written -Cusually track 
□> containing information about the allocation and character¬ 
istics of the device* This label track consists of a label 
sector*! n PRUs containing the TRT for the device -Cas of last 
checkpoint} and label sectors on the first sector of each 
unit of the device* The layout of the label track iss 


Logical 

Sector 

0 


1 


Phys * 
Sector 

0 


LABEL 


1 


TRT 


Physical 
Unit No. 


u 

m = no* of PRUs per 
unit in logical 
track 


u 


m 


0 


LABEL 


u+1 


5m 


0 


LABEL 


u*»-5 


The label has the following format■ 
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CCSS Catalog Count 

CDSS Device Mask 

DASS First Track of 
Indirect Files 

ALSS First Track of 
Catalogs -CLabel 
Track! 

PRSS First Track of 
Permits 

ETSS Equipment Type 
SLSS Sector Limit 


FNSS 

DTSS 


SNSS Sector Number 
■CLogical! 

UTSS First Idord of 
Mass Storage 
Table -Cas of 
Last Check Point! 


LMSS Limit of Data in 
Label Sector 


CESS 


COSS Catalog Ordinal 
for device -Cfor 
devices run 
under S.P! 


WCSS Word Count of 
fIST - 0 if no 
flST present 
-Clabel written 
under 2.0! 

Tags Defined in 

COfISDSL or 
SYSTEXT 


ESSS 

MTSS 


nSTL J 


ESSS EST entry for device 


^LMSS 


DEVICE LABEL 


LA 

BE 

LOO 

POP! 

OSOO 

E(3SS 

FTSS 



FASS 

PACKED DATE AND TIME 








CCSS 

. 

CDSS 



DASS 

ALSS 

PRSS 


ETSS 

SLSS 

SNSS 



COSS 

UCSS 

_ ..1 





i 









. 1 





j 

a 

a 

a 

a 

a 

a 

a 

MST - 

See I 
MST 

etail 

of 
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M'O Direct Access File System Sector Format 

Because data retained in the system sector for a direct 
access file is of concern during recovery of a device the for¬ 
mat of this sector is described in the following table* 
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FCCA = Current Access 
Bits 

b) Urite - 11 
P Purge - ID DTSS 
E Extend - M 
f1 Modify - 3 
R Read - D 

CTUC = Current User 
Count 

FCFA = FST address of FAST 
ATTACH entry asso¬ 
ciated with this 
file.** 

CTSS 


P.F. 

Catalog 

Entry 




JCNOTE: Tags defined in SYSTEXT 


or COMSPFM 

See User Profile Control ERS 


Direct Access File System Sector 



F I L E N A n 


EflSS 

FTSS 



FASS 


PACKED DATE AND TIME j 





— 

r 










[TT^a 

UP EM 1 

1 





1 


























FCFA 

1 






“i 

1 













CTUC 

! 






j 

i 


1 

1 

1 

. 
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EST ENTRY 


ST 


T7 


M3 


3S 


23 


11 


MSPICU 


CH2 

CHI 


NU 

PS 

PU 

B 


DEVICE TYPE 


nst/io 


Bit Position 
ST 


n = Hass Storage 
S = System on Device Sfl 

P = PF*s on Device S? 

I = Interchangeable Device Sb 
C = Checkpoint Request SS 

U = Device Unavailable SM 

PE = Physical Equipment 33-3S 

NU = Number of Units 30-32 

PS = Select Code 27-2T 


1 = Drive 

2 = File 

PU = First Physical Unit 2'4-2ti 

B = Device Unavailable for 

System Allocation 23 


MASS STORAGE TABLE CMST} 


ST M7 3S 53 



Number of 

PPU 

•s 

Length of 


Available 

{Hi 

nimum} 

TRT 


11 0 

Number of 
Available 
Tracks 


TRTL 


AA 3777 


nONIEDMUSA 



CONTROL DATA CORPORATION 


DOCUMENT CLASS_ 

PRODUCT NAME_ KRONOS £«! 

PRODUCT MODEL NO. £066*5.1 


DIVISION 


PAGE NO. 


II 


B-6 Rev A 


MACHINE «piP.= l.aOO/Cl>C CYBER 75.73 .74 


nST -CContinued! 


ST M7 3S 


17 


□ 


Current 

Position 

F 

E 

USLM 

_ 

Maximum Sector 
Limit 

Minimum Sector 

Limit 


nSDL 


F = Format Pack Request Pending {6NM only! M7 

E = Release Reserve when Releasing Channel Mb 


USLM = Unit Sector Limit for Multi Unit Device 3b“HS 


ST__ 0 

RESERVED FOR MASS STORAGE DRIVERS i 


ST _ _ ■ ....0 

RESERVED FOR MASS STORAGE DRIVERS I 


ST 

First Track 
of Indirect 
Files 


M7 3S 53 


Label Track 


First Track 
of Permits 


Actual 
Number of 
Catalogs 


11 0 

---j 

, System 
I Table 
Track 


DEVL 


ST S3 M6M7 M3 53 11 “I 

15 1 0 


D 

G 

N 

R 


A 

1 

Reser¬ 

ved 

Number of Holes 
in PRU's 

Direct 
Access File 
User Count 

kext 
E(3 id 
pair] 


U 

T i 

i 

I 

L— 

PFIL 


D = Direct Access Files may reside on device S3 

G = Initialize Request Pending S5 


N = Not Available for PF Access SI 
R = Removable Device SO 
A = Alternate System Device Ta 
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U = In use as chained interchangeable device 2 
T = Total Device Interlock -CUtility Interlock! 1 
I = Device Interlock -Cnot set = busy! □ 
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fIST {Continued> 


5*1 


17 11 7 0 


Family/Pack Name 


Device 

Number 


0 


Device 

(lask 


PFDL 


X = Catalog Tracks Continuous 11 

0 = Catalog Track Overflowed 10 


5*1 


17 


0 


User Number for Private Pack 


PFUL 


5*1 ________ 0 

Reserved for Future Use -CM words} 


5*1 


Reserved for Installation Purposes CM words} 


ISTL 
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APPENDIX C 

DAYFILE AND OPERATOR MESSAGES 


DAYFILE MESSAGES 

♦BUFFER OUT OF RANGE.♦ = Buffer outside of field length. 

♦E(3NNlUNITXX LABEL CONFLICT.* = Label of device conflicts with MST 
parameters. 

♦E(3NNi PERMANENT FILE LINKAGE ERROR.* = TRT edit was unsuccessful. 

*E(3NNi TRT LENGTH IS BAD.* = TRT read was unsuccessful. 

*PF LENGTH ERROR UINDEX FILENAM.* = End of linkage in TRT for D.A-F. 
is not an EOI sector. 


DEADSTART MESSAGES 

♦ CATALOG RECOVERY ERROR IN CM-, DATA FROM LABEL IS USED.* = Device 
layout parameter did not verify against the label. 

♦CONFIGURATION IS IN ERROR. RECOVERY OF DEVICE IMPOSSIBLE.* = Label 
did not verify. 

♦ DEVICE DESCRIPTION ERROR IN CM-. DATA FROM LABEL IS USED.* = Device 
mask-, family name or device number did not verify. 

♦ DEVICE RESIDENCE CONFLICT IN CM-, DATA FROM LABEL IS USED.* = Device 
and CM do not agree on residence. 

♦EST/FNT LENGTHS CONFLICT-, RECOVERY OF DEVICE IMPOSSIBLE.* = Table 
lengths did not verify correctly. 

♦LABEL ERRORS ON UNITNN- RECOVERY OF DEVICE IMPOSSIBLE.* = No label 
sector found on device. 

♦LENGTH OF DEVICE TRT BAD. RECOVERY OF IJEVICE IMPOSSIBLE.* = Error 
in TRT read from mass storage to CM. 

♦PERM. FILE LINKAGE ERROR- RECOVERY OF DEVICE IMPOSSIBLE.* = TRT 
edit resulted in error. 

♦SYSTEM TABLE FILE DESTROYED. RECOVERY OF DEVICE IMPOSSIBLE.* = No 
system table track found. 
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OPERATOR MESSAGES 

♦RECOVERING PF.EiJXX. TRK NNNN.* = Indicates equipment and track being 
recovered. 
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APPENDIX D 


Permanent files created under S-D systems may be recovered by 5>1 
systems using the following method. This method applies only to 5.0 
systems updated through level 10. 


To determine the permanent file definitions needed for 5.1 CMRDECKt 
use the following. Note the PF entry is not required for 5.1 
recovery-! but is included here to describe PF characteristics of 
PF device. 

1. If the PF status was S under 5.0 use PF status D for 5.1. 

5. If the PF status was D under 5.0 use PF status I for 5.1. 

3. The device mask should remain the same for both systems. 

M. The family name for 5.1 should be null since no family name was 
possible for 5.0 systems. 

5. The device number for 5.1 should be the catalog ordinal of the 
device under 5.0 biased by MOg. 

As an example: 

If 5.0 CMRDECK was: 

Efl0=DB-i0N-.l-.0i0. 

E(21-DB-!0N-!l-.0-!l. 

E(35=nD-M-.0FF-.M-,0i5. 

Efl3=l1D-5-iONiM-!M-i5. 

PF=l-i0N-.S-.. 

PF=5-.0N-.D-,377. 

PF=3-,0N-.S-i. 

Under 5.1 the CMRDECK should be: 

E(JO=DB-.ONt1-iO-.0. 

L(i2 1~D B 1 0N 1 1 1 0 1 1. 

E(35=nD-M-.0FF-.M-.0-.5. 

Ei33=nD-5-.0N-.M-.M-.5. 
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PFs=l •. ON iDMO. / 

PF=2iONiI-i377Tim. } Not required unless initializing. 

PF=3-. ON MS. J 

As long as the permanent file devices are not reconfigured! either 
under S.O or S.l-i the installations can alternate between B.O and 
a.l systems without reloading permanent files. 


NOTE: The limitations exist that no family name may be used as long 

as regression to S.O is desired. Also removable devices will 
not be accessible under S.O. Also to have a device which was 
considered dedicated under B.O •CPF=mstiDidm->! the device 
should have I type residency under B.l and equipment status 
should be OFF. In the previous example-i equipment B will 
contain only users catalogs and indirect access files. 
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APPENDIX E 
MDI K-DISPLAY 


*** MASS STORAGE DEVICE INITIALIZATION *** 


CURRENT 




OPTION 


VALUE 

DESCRIPTION 

FN 

= 

0 

FAMILY NAME 

PN 


0 

PACK NAME 

UN 

= 

0 

USER NUMBER 

PW 


0 

PASSWORD 

DM 

= 

0 

DEVICE MASK 

NC 

= 

0 

CATALOG TRACKS 

E(3 

=: 

0 

EST ORDINAL OF DEVICE 

NU 


1 

NUMBER OF PACKS 

DN 

= 

0 

DEVICE NUMBER 

PU 

s 

0 

PHYSICAL UNIT OF PACK 

OP 

ss 

0 

OPTION-, 0=FULL INITIALIZE 


1=INITIALIZE AND RECOVER FLAWS 
2=ENTER FLAWS 
3=F0RMAT PACK -CflMM} 

RTK-, STK AND TTK ENTRIES-. ENTER SINGLY 

GENERAL FORMAT- XTK=A. 

WHERE-, *XTK* IS- 
RTK = RESERVE TRACK 
TTK = TOGGLE TRACK 
STK = SET LOGICAL TRACK 
AND *A* = EQUIPMENT FORMAT- 
DA - Taao-,Go-.soQO 
DB - POQ-.HOO-,SOaO 
DC - UO-,GDO-.AOODDO 
DD - CDOO-iSODO 
DE - AOOQOOO = ADDR/lOB 
DF - COOO-.SOQOQ 
DH - CODOD-.SOODD 
DI - COOO-,TDD-.SOO 
MD - COaO-,SOQOO 
LIMIT = SOB ENTRIES. 
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1.0 SCOPE 

This document describes the XRONOS 2.1 enhancements -Cover the 
KRONOS 2.0 system> in the area of permanent files and the 
utilities. 

The basic purposes for these enhancements are: 

1. Improve allocation of indirect access files. 

2. Improve the usage of free space on permanent file devices. 

3. Control use of permanent files. 

M. Optimize catalog manipulation. 

S. Provide new access modes for direct access files to allow 
multiple users to read a file while one user is modifying 
that file. 

h. Provide command to alter parameters in catalog entry. 

7. Provide capability to initiate procedure files that are 
permanent files. 

ft. Provide better and more reliable utilities for the installa¬ 
tion's maintenance of the permanent file base. 
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2.D APPLICABLE DOCUMENTS 


2«1 KRONOS 2.1 Product Objectives Document EDSfl^B.l 

2*2 ICRONOS 2*0 Batch User's Reference Manual - STISOLOD B 

2.3 KRONOS 2.D Time Sharing User's Reference Manual - 5*1151300 B 

B.H KRONOS 2.0 Operating Cuide - 5^151LD0 B 

2.5 Interchangeable Device ERS 
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3.0 1>ESCRIPTI0N 

3.1 Improved Allocation of Indirect Access Files 

The allocation of indirect access files is improved by the 
following method. Formerly pFil searched for an indirect access 
file hole for allocation of the file requested. The requirement 
was that the hole must be within two sectors of the file in order 
to qualify for a hole plug. This has been altered to plug the 
largest hole found on the catalog track and create another hole 
for the remaining space. This new hole is kept on the same 
catalog track. This new method has the advantage of requiring 
allocation of space on the PF device less frequently. 

3.2 Improved Usage of Free Space on Permanent File Devices 
Two methods are used to improve usage of free space on an 
indirect access file device. Both of these methods are designed 
to make free space available to any user's PFH request. 

3.2.1 When an indirect access file is purgedn if the hole created 
extends across a logical tracki PFM releases this track back 
to the pool of available tracks for allocation by the system. 
This requires delinking of a track via a CPUfITR function from 
within the indirect access permanent file chain. This method 
has the advantage of making the track released available for 
allocation on the device t for any users access t not just those 
on the same catalog track. 
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The new CPUfITR function DLKM has been added to perform this 
function. The format* is: 


DLKP - DELINK T-^flCKS. 


FNTPY 


OR / OLKN / PD /FT /NT / LT / 


n FOUIFHENT NUMPEP 

FT TFAfK ONTD WHICH NT IS LINKED, 

N'T TRACK TC PE LINKfP TO FT, 

LT last TRAPK IH chain TO DROP. 

PIT 11 OF FT HUFT Pf PLFAP 

all tracks FPOH FT (NOT TNCLUQINC FT) TO LT A'-’P PELEASr'', 
NT TS LINKFC TO FT. 

FXTT. 


OP /O / 


3.2.2 If the file being released is the last file of the indirect 

access chaini then the space will be released from the indirect 
access chain. 


» See Instant KRONOS for description of CPUilTR functions. 
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3.3 Control Use of Permanent Files 

Because of the characteristics of the Permanent File Subsystems 
i»e.s the generation of a working filei users grouped by catalog 
tracks etc*s it has been possible for users to generate and 
access permanent files in such a manner as to impair other user's 
access to their permanent files. For example: If a user accumu¬ 
lated a large number of filesi then catalog searches for all users 
in his user group took that much longer. Alsos a user could 
accumulate more space than a site wishes to allow. 

As an example: 

Uhen accessing the files-i it was possible to generate PFM 
requests in rapid succession ■> causing the system to con¬ 
tinuously search the PF catalogs. An example of this would 
be when a user wished to access a direct access file and 
found it interlocked. There was nothing to prevent him 
from immediately retrying that request ■» thusi keeping PFH 
searching that catalog. 

3.3.1 To alleviate these situations-! three areas are altered. 

3.3.1.1 For any particular user there are limits-i as defined in the 
VALIDUS file-i for the number of files he has in his catalog. 

If he attempts to exceed this limiti he will be aborted with 
"CATALOG OVERFLOU - FILES." message issued. 
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Alsoi there are limits on the cumulative size of the files 
for a user* This is accumulated for indirect access files 
only* If the user attempts to exceed thisi he will be 
aborted with message "CATALOG OVERFLOU - SIZE." 

Finally-! there are limits on the size of any individual 
indirect access file that is being placed on the device. If 
this size is exceeded-! the message *FILE TOO L0NG« will be 
I issued and the request aborted* 

3* 3*It* 1.1 Job Origin Controls 

For each job origin type-i controls may be specified which 
limit the users' access to permanent files. These controls 
are used only if individual user controls are not specified. 
These values may be specified in IPRDECK* or via OSD console 
command.** The format of the SERVICE command is: 

SERVICE -!Ot-!pixxxxxx 

Options added.*** 

£i 

FC Number of permanent files allowed. This number is 
I rounded down to nearest lODB* 

CS Cumulative size in PRU's allowed for all indirect 
access files. This value is multiplied by IGOB to 
determine limit allowed. Maximum value entered is 
777777B. 

* Refer to Operator’s Guide-! page 5-17 for description of SERVICE 
entry. 

** Refer to Operator's Guide-i page 3-*^ for description of SERVICE 
command. 

♦** All numbers are octal unless otherwise specified. 
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FS Size in PRU’s allowed for individual indirect access 
permanent file. This value is rounded down to near¬ 
est lOOB PRU*s. Maximum yalue is 777777B. 


3.3.1.1.S Individual User Control 

If it is desired to control specific users* permanent file 
access differently than that specified by origin type then 
the controls defined by the users’ validation entries 
should be specified. These can be specified when defining 
or updating the user number via the MODVAL utility.* Three 
control parameters have been added to the MODVAL directives. 

PC = n Number of permanent files allowed, n is a 
value from 0-7 which specifies the upper 
limit allowed. 

II upper limit allowed** 

□ use job origin control 

1 100 

B SOO 

3 HOO 

M 1000 

5 5000 

h 10000 

7 unlimited 

If FC is not specified 1 0 will be assumed. 

CS = n Cumulative size for all indirect access files, 
n is a value from 0-7 which specifies the 
upper limit allowed. 

n upper limit allowed**-CPRUS> 


0 use job origin control 

1 1000 

* See Operator’s Guide•« page B-b for definition of parameters that 
can be specified. 

** These values are specified in COMSPFM and require reassembly of 
system to alter - all values are octal unless otherwise specified- 
If value is zero-i no controls are enacted. 
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FS = n 


S SDOO 

3 5000 

M 10000 

5 50000 

(a 100000 

7 unlimited. 

If CS is not specified! 0 will be assumed. 

Size allowed for individual indirect access 
permanent file, n is a value from 0-7 which 
specifies the upper limit allowed* 

£1 upper limit allowed»- CPRUS> 

0 use job origin control 

1 10 

2 20 

3 30 

M MO 

5 50 

b bO 

7 unlimited 


If FS is not specified-I 0 will be assumed. 


3*3* 1*2 Uhen a user attempts to access files that are interlocked-! 

the system automatically suspends the job until the file 
becomes available* This is available for the ATTACH function 
only* 


The ATTACH command-* and control card-i automatically do this 
and the error flag is not set if the file is busy* The user 
may bypass this automatic suspension-i by specifying the A 
option on the control card* 


* These values are specified in COMSPFM and require reassembly of 
system to alter - all values are octal unless otherwise specified. 
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If this option is specified ATTACH Clfn/A > the system 
aborts the command if the file is busy.» The user calling 
PFM via the macros provided-i can bypass this automatic 
suspension by specifying error processing*** If error 
processing is specified t the system returns control to the 
user with error status reflecting *FILE BUSY*. 


3*3.1*3 tilhen a user defines a direct access filei it is placed on 

the device with the most space available unless the request 
indicates a specific device type. If more than one of a 
device type exists-i the file is plv\ced on the one with the 
most space available. The *S* para&ter specifies a PRU 
count. This indicates the amount of space desired for file. 
The system will place the file on a device -Cof type specified 
by *R*> with this much space available. If no device has 
this space available the dommand will be aborted with the 
message »RE(3UESTEI> SPACE UNAVAILABLE.*. No guarantee is 
made that the space currently available will be available 
when the user expands the file. 


* See Section 3.5 for further definition of file busy situations. 
** See Batch User’s Reference Manual-i page T-b? for methodiof error 
processing. 
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3*3>1*3>1 Format of Control Card* 

DEFINE <lfn®pfnilfn 2 j=pfn 2 ^ 1 • • • ■ilfnj^=pfn^/ Plil=password-i 

CT=ct-i R=rT n=mT S=space-. PN=packname>** 

The S parameter is a decimal PRU count. 

3*3.1.3.2 Format of Macro*** 

[ DEFINE Clfn-i pfn-i pwdi u-» ri ct m-» pnn s>** 

I 

S is PRU count desired. It may be set in FET word ^ 

{CFOU} right justified bits {0-53}. 


* See Batch User's Reference Manuali page S-S5 for description of 
parameters for DEFINE command. 

** See Interchangeable Device ERS for description of PN parameter* 
*** See Batch User's Reference Manual t page 1-11 for description of 
parameters for DEFINE macro. 
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3.M Optimize Catalog Manipulation 

3•^.l Because more than one copy of PFM may be activen certain 
situations arise when the device or catalog track must be 
interlocked {see description on interlock! Section M.?}. PFM 
is modified to interlock only those areas required and only 
when the type of request requires it. This also allows the 
utilities to run concurrently with PF requests! since they can 
request the interlocks also. The utilities interlock the device 
and then wait for catalog interlocks to be available. If 
an utility operation is currently taking place! the user 
receives the message PF UTILITY ACTIVE and the Command is 
aborted. This occurs only for PF requests issued by TELEX 
{i.e.! 0L1>! LIBi GETn PURCE! PERMITi and ATTACH! and not forced 
as control card requests {via batch mode X! GET.>. Ail other 
PF requests {BATCH, REMOTE BATCH, SYSTEM and TELEX control card 
requests} go on recall and wait for utility interlocks to clear. 

3.'l.B Former catalog search methods are modified to take advantage 
of an additional buffer in PFM. For all commands the catalog 
is searched only once to determine the action to be taken. 

Former methods required two passes over the catalog for certain 
commands. 
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3.M.3 When a direct access file is purgedi no hole is createdn 
however-* a "null" catalog entry is created. These null 
entries are used by PFM when creating a catalog entry for a 
new direct access file. 

3.H.‘< Access to permission information is optimized to take advantage 
of an additional buffer. 
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B>S New Access Modes for Direct Access Files« 

The access to KRONOS permanent files are enhanced to include 
four new modes for direct access files* These modes are: 

MODIFY - Modify File 

READMD - Read and Allow File Modifications 
READAP “ Read and Allow File Extensions 
APPEND - Only Allow Extensions to File 

3.£.i MODIFY 

Accessing a file in this mode allows a user to replace any 
information within the file -CREURITE} or add information at 
the end of the file. As an example-i randomly rewriting a PRU 
within the file is permissiblei but writing a PRU somewhere 
within the existing boundaries of the file in a mode that would 
release all trailing information is not. This mode has signifi¬ 
cance only for direct access files. The format of the command is: 
ATTACH-Clfn/M=M> 

3 . 5.5 APPEND 

This command still exists and causes an existing local file to 
be appended at the end of an existing indirect access file.** 

A mode of access exists for direct access files which allows a 
user to write a file only at the existing EOI. This is the 
append mode of access. The format of the command is: 
ATTACH-Clfn/M=A} 

* Refer to Batch User’s Reference Manual for existing modes. 

*♦ See APPEND command -1 Batch User’s Reference Manuali page S-S3 for 
further description. 
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3.5.3 READHD 

A mode of access exists for direct access files which allows a 
user to specify read access to a file with the indication that 
another user may currently be accessing the same direct access 
file in MODIFY mode. This user can be assured no one will 
destroy the file that existsi but that other users may alter 
the data within the file or add to the file at EOI. This mode 
of access has meaning only for direct access files. The format 
of the command is: 

ATTACHafn/f1«Rn> 

3.S.M READAP 

A mode of access exists for direct access files which allows a 
user to specify read access to a file with the indication that 
another user may be currently accessing the same direct access 
file in APPEND mode. The user can be assured that no one will 
destroy the file-* or alter the data that exists on the filei 
but that they may add data to the file at the current EOI for 
the file. This mode of access has meaning only for direct 
access files. The format of the command is: 

ATTACHafn/n=RA> 

3.5.5 Internal Characteristics 

Some confusion may arise in the resulting current access mode 
of a direct access file when some of the modes Just descr'ibed 
are specified and the file is already active with another mode. 
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This can perhaps be clarified by breaking the possibilities 
into three groups: 

Current access uritei read access desired 
Current access read-i read access desired 
Current access readn write access desired 
The following tables will describe the resulting current 
access associated with the direct access file for the 
possible combinations for these three groups. This status 
should not be confused with the mode the user will have 
when requesting access. For instancen in Table Ai READilD 
access is desired and current access is MODIFY. Resulting 
current access indicates one user is modifying and at least 
one user is reading the file. The user requesting READMD 
access to the file gets read only access. 
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3«S«5*]i Response to Current Access lilrite/Read Access Desired* 



.1 

Current Access 1 

Access Desired 

WRITE-CUl 

nODiFYcri} 

APPENDCA} 

READ {R> 

FB 

FB 

FB 

EXECUTE CE} 

FB 

FB 

FB 

iREADdD {Rfl} 1 FB i MODIFY/READ 

1 APPEND/READ 

1 APPEND/READ 

[readap ■cra> 

[ FB 1 FB 


TABLE A 


3.S.S.2 Response to Current Access Read/Read Access Desired 


Current Access 


Access Desired 

j- - -. .. - - 

READ-CR} ] 

readud-cru} 

i 

READAPCRAJ ' 

{FREE} ' 

jREAD CR} 

READ 1 

READ 

\ 

READ ; 

READ 

EXECUTE CE} 

READ I 

READ 


READ i 

READ 

READUD {RI1> 

READ ! 

READUD 

i 

) 

READAP 

READflD^ 

READAP CRAl 

READ r 

READAP 

t 

READAP 

|~READApJ 


TABLE 

B 





3-S.S.3 Response to Current Access Read/Urite Access Desired* 



Current Access j 

Access Desired 

READ 

READMD 

READAP 

{FREE} 

URITE {W} 

FB 

FB 

FB 

^ write' 

MODIFY {Ml 

FB 

MODIFY/ 

READ 

FB 

MODIFY 

APPEND {A} 

FB 

APPEND/ 

READ 

APPEND/ 

READ, 

APPEND 


TABLE C 

Only one user at a time may access file irt any of the 
write modes CliJ-i At M}. 


» FB = File Busy 
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The results from the previous tables can produce confusing 
results if certain operations are performed. For example: 

Assume one user is accessing a file with READIID mode 
and another user desires READ access. The resulting 
mode {READ *— see Table 3} will prevent any other user 
from write access. So the sequence: 
li ATTACH-CRn=DA/n=RA} 

2 -. ATTACH{ljn=DA/n^A> 

may produce a '*file busy" response for the second 
ATTACH if another user has attached the file in READ 
mode between control cards 1 and 2. 
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3 «S*(9 External Characteristics for New Nodes of Access 


ATTACH Control Card* 

For the NODE parameter the new options are: 
Full Parameter Alternate Short Form 


APPEND 

- 

A 

APPEND ONLY ACCESS 

NODIFY 


N 

NODIFY ONLY ACCESS 

READND 


RN 

Read and allow modification 

READAP 


RA 

Read and allow append 


3.S.b.5 ATTACH NACRO** 

For the mode parameter the new options are: 


Value 

Nnemonic 

Short Form 

Description 

2 

PTAP 

A 

APPEND 

5 

PTND 

N 

Nodify 

b 

PTRN 

RN 

Read allow modify 

7 

PTRA 

RA 

Read allow append 


For example: 

ATTACH FiXl-inRN will request read and allow modify 

mode* 

or 

ATTACH F-,Xl-.-.-,NDE 
where 

NDE CON PTRN will produce same* 


* Refer to Batch User's Reference Nanual page S-S3 for further 
description of ATTACH command* 

Refer to Batch User's Reference Nanual page 7-7T for further 
description of ATTACH NACRO* 
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3«S«b>3 Error riessages 

Reference the Standardization ERS for error messages that 
can be issued when a write operation is requested in a 
direct access file that is attached in one of the new modes- 


I 


AA 377? 


PRtKTBD IN USA 



CONTROL DATA CORPORATION 

-DIVISION 

DOCUMENT CLASS___^_NO. ^ I 

PRODUCT NAME KNONO^ d-M ___ 

PRODUCT MODEL NO. £066*5.11_MACHINE <;PRiP<;t3000/CDC CYBER 75-,7317 ^ 


3.J.b.1 Permission Modes 

Permission modes can be associated with a permanent file 

or a user of a permanent file. 

1 . Permission modes of files are defined by specifying the 
M parameter on the SAVE or DEFINE command, this mode 
will have significance only to public or semi-private 
files. Uhen a user accesses files-i the mode of the file 
will designate the type of access allowed. 

5* Permission mode for users of a file is meaningful only 
for private files. This mode is specified by issuing 
the PERMIT command. This mode will control the type 
of access an alternate user is allowed. 


The following table describes the mode of access specified 


and the mode of access allowed. 


Specified 

URITE 

READ 

APPEND 

EXECUTE 

NULL 

MODIFY 

READ/ALLOld MODIFY 
READ/ALLOU APPEND 


Allowed 

URITEi READ-, APPEND-. EXECUTE-, 
MODIFY 

READ-, EXECUTE 

APPEND 

EXECUTE 

NEGATE ALL EXISTING PERMISSIONS 

MODIFY-, EXECUTE-, READ-, APPEND 

READ-, EXECUTE-, READ ALLOU 
MODIFY 

READ-, EXECUTE-, APPEND-, READ 
ALLOW APPEND 
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The following list describes the type of permission necessary 
to perform an operation on a file in an alternate users 
catalog* Users accessing files in their own catalog have 
full -ClilRITE} permission* 


Command 

Permission Needed 



GET 

EXECUTE 



APPEND 

APPEND 



REPLACE 

WRITE 



SAVE 

Alternate Catalog access 

not 

allowed 

ATTACH 

Mode specified CREAD is 

default} 

DEFINE 

Alternate Catalog access 

not 

allowed 

PURGE 

WRITE 



PERfllT 
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3.b New Permanent File Commands 

3.b.l CHANGE 

This command will allow a user to alter any of several para¬ 
meters for a permanent file without retrieving and replacing 
the file itself. 

J.b.l.l Control Card Format 

CHAN6E'Cnfn=ofn/CT=file cat.i ri=modei Pld=passwordi PN=paclcname} 
nfn * new permanent file name 
ofn = old permanent file name 
If ofn omitted-! then no name change will take place. The 
following parameters should be entered only if a change in 
the value associated with that parameter is desired. 

CT = file category* 

H = mode* 

PU * new password 

PN = packname. This designates file resides on this 
removable device. 

NOTE: This command will cause modification and last access 

date to be updated for the file being processed. 

Only the owner of the file may perform this functioni 
•Ci.e. 1 UN is illegal parameter!. 


* See Batch User's Reference Manualn page S-Sl for legal options for 
these fields. 
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3»b»l»5 Macro Format 

CHANGE fipfinpfipw-iucictimipn 
f = address of FET 
pf * old permanent file name 
npf = new permanent file name 
pw = new file password 
uc = user control word 
ct = new file category 
m = new file mode 
pn = packname* 

Error Messages 

*{file name} NOT FOUND.* Permanent file name specified was 
not found in catalog. 

*-Gfile name} ALREADY PERMANENT.* New permanent file name 
specified already exists in users permanent file catalog. 


* See Interchangeable/Removable Device ERS for explanation of this 
parameter. 
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'i.b.3 PUR6ALL 

The PURGALL command will purge all permanent files 
that satisfy the criteria specified by the arguments. 


3.b.5.1 Control Card Format 

PURGALL-CCT=file cat. t AI>=access datei ri])=modification daten 

CI>=creation date-i 3>N=device numberi TY=type-! Tn=timei 
PN=packname> 


CT = file category* 

DN » device number 
TY = file type 

Option Short Form Description 
INDIR I All indirect files 

DIRECT D All direct files 

ALL A All files 

If options are not present -CALL! is default 
AD = last access date 

Ml) = last modification date ( d^tJ* 

CD = creation date ^ 

Format of date: 
yymmdd 


yy ® year - last two digits of year 
mm = month "Cl-15> 
dd = day -Cl-3l> 

Th = time of day. This applies to date specified by ADi 
_ nP-. or CD. 

* See Batch User’s Reference flanuali page S~£l for legal options for 
these fields. 
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Format of time: 
hhmmss 

hh = hours D-23 
mm = minutes 
ss = seconds Q-S®! 

PN = packname 

The command is aborted with the message ERROR IN 
ARGUHENTS when one or more of the following conditions 
are detected: 

- more than one date entered. 

- no options selected. 

- identifier not recognized. 

- time present with no date. 

~ both device number and packname present. 

To purge all files for a catalog enter: 

PURGALL-CTY=A} 

CTi DNt TYt TH and either AD-i MO-i or CD may be entered 
simultaneously. 


3.b.2.S No macro will be provided for this command. 


B.b.E.S Error Messages 

* ERROR IN FILE CATEGORY.* = file category specified is not 

legal. 

* ERROR IN file TYPE.* = file type specified is not legal. 

* ERROR IN DEVICE NUMBER.* = file residency specified is not 

legal or not available on the 

system. 
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* ERROR IN DATE.* = format of date is incorrect. 

* ERROR IN TIME.* = format of time is incorrect. 

* ERROR IN PACKNAME.* = packname is more than 7 characters. 
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3.7 Procedure File Processing 

The CALL statement* has the capability of activating a procedure 
file from a permanent filei local file or system library. 


3.7«1 Control Card 

CALL {lfn-.pl-.p2nRENAIlE-Cfl=el-.f2=e2-,.. .fn=en» 

CALL •Clfnipl-ip2{fl=el-,f2=e2n...fn=en>} 

Ifn source file name 

Ifn will be located by - 

1. Search for local file. 

2. Search system library. 

3. Attempt to retrieve indirect access file from 
permanent files. 

pn any of the following arguments in any order . 

C clear current statement file before entering. 

S set next control statement to first statement. 

S=ccc set next control statement to statement number ccc* 

RCNAMC for each occurrence of the name *fn*-i on source filei 

substitute the name *en*. 


3.7.2 Terminal Command 

The terminal user can initiate the CALL statement in the Batch 
subsystem. In any other subsystem the command *- Ifn* will be 
translated into the CALL -Clfnl statement and processed by the 
system. All parameters after the *-* will be compatible with 
the CALL statement. 


* See Batch User's Reference Manualn page for more complete 
description. 
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3*6 PF Utilities 

A majority of the enhancements to the permanent file utilities 
increase the reliability of the maintenance of the permanent file 
system and reduce the operational effort and time required to 
maintain archive files. All of the utilities may be called from 
control cards provided that the job containing the control card 
has "system” origin type. All of the utilities except Mass storage 
Device Initialization -CflDll may be invoked through the permanent 
file supervisor -CPFS! display. The following sections describe 
the utility supervisor program and the permanent file utilities. 

PFS - Permanent File Supervisor 

PFS processes all permanent file utilities parameters. Then 
it loads the correct processing overlay. Utilities may be 
called from the operator's console by the following methods.* 

1. X.PFS. 

This method employs the following sequence of operator 
commands: 

X.PFS. 

K. uo. 

K.plipS-i... ipn. where the parameters are of the form 

keyword = value. 

K.60. 


» See Operator's Guide•» pages 7-1 and 7-2. 
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The "uo" options are given in this table: 
Utility 

Options -Cuol Utility 


LO 

DU 

CA 

AT 

CP 


PFLOAD -• Load Permanent Files. 

PFDUMP “ Dump Permanent Files. 

PFCAT - Catalog Permanent Files. 

PFATC - Catalog PF Archive Tape. 

PFCOPY - Copy PF Archive FileCsl to CP. 


2. X.PFutil{plip2i...-ipnl 

This method employs the operator command: 

X.PFutil-Cpl-ip2i... Tpn> 

where the parameters are of the form keyword = value. The 
"util” options are given in this table: 

Utility 

Options Cutill Utility 

LOAD Load DeviceCsl 

DUMP Dump Device-Csl 

CAT Catalog DeviceCs} 

ATC Archive File Catalog 

COPY Archive File Copy 

By issuing this commahdi the K-display will appear for 
this control point with the parameters entered shown. 
Howeveri since parameters were entered on the control cardn 
no parameters may be entered via the K-display. If there 
is an error in parameters detected at initiation or during 
execution of a utility-! control will be returned to PFS 
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and paraiTieters may then be entered via the ((-display. 

liiherever possiblei parameters available for the utilities will 
be compatible with all utilities. For both of the above 
methods ■» the following table illustrates all possible parametersn 
options available for these parameters t and for which utilities 
they are valid entries. 
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FN * Family Name 
PN * Pack Name 
DN * Device Number 
T = Archive File Name 
LO = List Option 

T - Files Processed 
C “ Catalog Files 
E - Errors 
S “ Summary 
L = Output File Name 
OP = Utility Option 
C - Creation 
A ~ Last Access 
n - Last Modification 
I - Indirect 
D - Direct 

B - Before Date and Time 
P - Purge after Dump 
R - Replace 

0 - Catalog and Permit 
Records 

N - Noninitial 
NR = No Rewind 
NU = No Unload 

SF * Number of Files to Skip 


PFLOAD PFDUMP PFCAT PFATC PFCOPY 


X 

X 

X 

X 


X 

X 

X 

X 


X 

X 

X 


X 

X 

X 


X 

X 

X 


X 

X 

X 


X 

X 

X 


X 

X 

X 

X 

X 

X 


X 

X 

X 

X 

X 

X 

X 


X 

X 

X 

X 

X 

X 


X 

X 

X 

X 

X 

X 


X 

X 

X 

X 

X 

X 


X 

X 

X 

X 


X 

X 

X 


X 

X 

X 


X 

X 

X 


AA 3777 


PKINTBDmuSA 



CONTROL DATA CORPORATION 

_——-DIVISION 

DOCUMENT CLASS__ PAGE Nin ^ 

PRODUCT NAME KRONOS 5.1 ___ 

PRODUCT MODEL Kin. EOfifi^S. l _ MACHINE cpRip*^ CYBER ?gT7 3-.?M 


PFLOAD 

N = Number of Files to Process X 


DT * Date X 
Tfl = Time X 
UI = User Index X 
PF = Permanent File Name X 
DI * Destination User Index X 


PFDUflP PFCAT PFATC PFCOPY 

X X 

X X XX 

X XXX 

X X X X 

X XXX 


V * Verify 

DD = Destination Device Number X 

NF * Master File Name 

UN - User Number X 


X 


X 


X 


X 


AA 5777 


PKINIB) W USA. 



DOCUMENT CLASS_ 

PRODUCT NAME_ 

PRODUCT MODEL NO. 


CONTROL DATA CORPORATION 
___DIVISION 

£5^_ PAGE N0.iII_3O£'l_i- 

KRONOS S.l ___ 

E0fia»5.1 _MACHINE ccgn=c t^OOD/CPC CYBER 75-.7 3 


Dayfile Messages 
None 

Operator Messages 

^ILLEGAL FUNCTION.* = illegal utility specified. 

♦ENTERED PARAMETER IS ILLEGAL.* = parameter is not in legal 

format. 


3*fi«1.3 Description of Permanent File Utility Parameters 

Sections 3.fl.1.3.1 through 3.6.1.3.25 describe parameters 
associated with the utilities which can be called by the 
permanent file supervisor {PFS>. 


3.6.1.3.1 FN = Family Name 

This parameter indicates which family is to be processed. 
This would not normally be entered unless more than one 
family were active in the system. The default is the 
normal system family. 

3.6.1.3.2 PN = Packname 

This parameter indicates which removable device is to be 
processed. Device must be mounted and available.* Default 
is no name. 

I ♦ See Removable Device ERS for definition of when device is 
mounted and available. 

AA 3777 

mwTGO m USA 


n?4 



CONTROL DATA C0RP08ATI0K 


DiViSSOH 


DOCUMENT CLASS__ p,,XGE md 

PRODUCT NAME _ KRONOS g. l _ ■ 

PRODUCT MODEL NO_ E066*5« 1 _MACHINE t;FRiFc; ^000/CDC CYBER 7a->7 3 t7 ^ 

3«fi«l«3«3 DN = Device Number 

This parameter indicates which logical permanent file device 
is to be processed. This would be used only if a portion of 
the permanent file system were to be processed* Normally 
all devices in a permanent file system for family> would be 
processed. The default is zero which indicates all family 
devices* This entry will be assumed entered in octal unless 
non octal digit is encountered or D radix is used. 

3.fi.l.3.M T = Archive File Name 

This parameter is the name of the file the utility is using 
to store or read the archive files. This would normally be 
the physical tape containing or to contain the permanent 
file system* This also could be a mass storage file. The 
default name is *TAPE*. 

3.6*1*3.5 LO = List Option 

The string of characters specified by this option specifies 
the type of output reports desired from the permanent file 
utilities. The default varies with the utility. 

T - list all files processed. 

C - list all files in catalog for system* 

E - list errors. 

S - list cumulative statistics for catalog. 

The options are specified as a character string. For 
example: 

LO = TES 
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L = File Name of Output 

This parameter specifies the file name reports are to be 
written on. The default is ^OUTPUT*. 

3.6.1.3.7 OP = Utility Options 

This parameter specifies the options which control the 

files to be processed by the utility, flany of the options 

require an additional parameter to further define the 

selections. The default is zero* 

C - select creation date. Requires TMi OT parameters. 

A - select last access date. Requires Tfl-i OT parameters. 

n - select last modification date. Requires TMt DT 
parameters. 

Only one of the options Cn An or fl may be selected at any 
time. 

I - select indirect access files. 

D - select direct access files. 

Only one of the options I or 0 may be selected at any time. 

P - Purge after dump. This option indicates to PFOUflP 
that those files he has dumped should be purged after 
the dump has completed. 

8 - Before date and time. This option indicates that 
the date and time options previously selected refer to 
those dates before which processing is desired. Normally 
the date and time options specify the dates after which 
ell files should be processed. 
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R - Select replace option* This parameter specifies 
to PFLOAD that files encountered on tape should replace 
files that exist in current permanent file system* 

Normally 1 if a file exists in a permanent file system t 
PFLOAD will skip loading of tha archive file* 

<3 - Select leading records* This parameter specifies 
to PFCOPY that two header records {catalog and permit! 
should be included when copying file-Cs>* 

N - Non-initial load* This parameter specifies to 
PFLOAD that permanent files presently reside on device 
to be loaded* PFLOAD does not load files that are 
already on device unless R option is specified* This 
only provides a check on master devices to assure that 
the operator intends to load to a device that already 
contains files* 

3*fl*l*3*fi NR = No Rewind Option 

This parameter indicates the file being used as archive 
file should not be rewound before processing begins* 

Default is rewind* 

NOTE; File must be positioned correctly as normal 

permanent file label will be read/written as first 
step* 
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NU Select No Unload Option 

this parameter specifies the file being used as archive 
file should not be rewound and unloaded at the completion 
of processing* The default is rewind and unload. 

3.6.1.3.10 NR and NU may be used to generate several dumps on one 
archive file in the following manner. 

To generate three ■C3> file dump tape: 

PFDUnPi...NU> Rewind before but not after pro¬ 

cessing. 

PFOUflPf.. .NRiNU} No rewind before or after process¬ 
ing. 

PFDUnPi••.NR> No rewind before but unload after 

processing. 

This same method of utilizing NR and NU options may be 
used by other utilities to process an archive tape which 
contains several dumps. Number of files option may also 
be used. 

3.6.1.3.11 SF = Select Number of Files to Skip 

This parameter specifies the number of files to skip 
before processing begins. The default is zero. This 
parameter is assumed decimal unless 6 radix is used* 

3.6.1.3.12 N = Select Number of Files to Process 

This parameter specifies the number of files on an archive 
tape to process. If set to zeroi all files to end of 
information will be processed. The default for this 
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parameter is zero* This parameter is assumed decimal 
unless B radix is used* 
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3>8>1*3<13 DT Select Date 

This parameter specifies the date to be used when Cn Ai or 
n option is selected* The default is zero* 

3*6*1*3*m TM = Select Time 

This parameter specifies the time to be used when Ci At 
or f1 option is selected* The default is zero* 

3*6*1*3*15 UI - Select User Index 

This parameter specifies the user index for which processing 
is desired* This parameter can be selected in addition to 
any other options* The default is zero* The parameter is 
assumed octal unless D radix or non-octal digit is used* 

3*6*1*3*113 PF = Select Permanent File Name 

This parameter specifies the permanent file name for which 
processing is desired* This parameter is associated with 
the UI option and is ignored if UI is not specified. The 
default is no name* 

3*6*1*3*17 DI = Select Destination User Index 

This parameter indicates to PFLOAD the user index under 
which the files beiiSg loaded are to reside* All files 
being processed will be loaded to this user index. The 
default is zero* The parameter is assumed octal unless 
D radix or non-octal digit is used* 
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3<6*l*3*ld V s Select Verify 

This parameter specifies to PFDUHP that verification of 
the file being written is desired* The default is no 
verify. 


On full permanent file system dump-i verification is done 
on a reel by reel basis* The verify will be a comparison 
between the verify file and the archive file* 


On selective or partial permanent file system dumpsi multi 
or single file dumps may be processed* The verify file 
will be compared to the archive file. 

NOTE: If NU parameter is specified-* verify will not take 

place* If NU parameter i^ specified-* then archive 
file and verify file will be rewound and verified. 

Example: 

PFDUnP <T=A-. V-* NU> 

PFDUnP -CT=A-* V-* NR-. NU> 

PFDUMP -CT^A-* NR-* V> 

at the completion of this step the verify will take place* 

At this point in time verify will take place between the 
entire verify file and file A. -CJust as if VERIFY-CA-*VER-* 
N=0> had been issued.} 
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3>6«]i*3«l*l By using the verify option and assigning file PFVER to 

tape before PFDUI1P is begun i a dual write of the archive 
file will be performed- The following diagram shows the 
difference between verify and regular dump. 



NOTE: This shows that archive and/or verify file may be 

assigned to tape or mass storage. 


» Either TAPE or MASS STORAGE 
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3»fl*2i*3«2D DD » Select Destination Device Number 

This parameter specifies the device number where files are 
to be loaded* This would normally be used by PFLOAD when 
reloading a portion of the permanent file base to a 
different device number* The default is zero* The 
parameter is assumed octal unless D radix or non-'octal 
digit is used* 

3*A*1*3*31 MF = Select Master File Name 

This parameter specifies to PFCOPY that all files extracted 
from an archive source are to be copied to this file name* 
Default is no name* Otherwise the archive files will be 
copied as individual files retaining their permanent file 
name* 
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3*6*1>3*25 UN ® Select User Number 

This parameter specifies the user number which is assoc¬ 
iated with the Pack Name parameter. This user number 
must match information in the mass storage table iflSTJ 
for the specified Pack Name. Default is no name. 
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Parameter Characteristics 

Family Name -CFNl 1-7 characters. 

Pack Name {PN> 1-7 characters. 

Device Number {DN> 5 octal digits. 

Archive File Name CT> 1-7 characters. 

List Option {L0> 1-7 characters. 

Output File Name -CLl 1-7 characters. 

Utility Options -COP} 1-7 characters. 

No Rewind -CNRl •C*NR* sets optionl 

No Unload -CNU> C«NU* set option! 

Skip Files -CSF! 2 decimal digits. 

Number files to process -CN! 2 decimal digits. 

Date {DT> b decimal digits yymmdd where yy = year-i mm = 
month-! and dd * day 

Time -CTII! b decimal digits hhmmss where hh = hour-i mm = 
minute 1 and ss - second 

User Index -CUI! b octal digits. 

Permanent File Name -CPF! 1-7 characters. 

Destination Index -CDI> b octal digits. 

I 

Verify {V> -C^V* sets option! 

Destination Device -CDD! 2 octal digits. 

Master File -CMF! 1-7 characters. 

User Number -CUN! 1-7 characters. 
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3«A«S fIDI *■ nass Storage Device Initialization 

flDI is not under the control of the Permanent File Supervisor 
<PFS>. Detailed description of MDI is located in the removable 
device ERS* 
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3.8.3 PFLOAD - Permanent File Load 

3.8.3.1 PFLOAD is a permanent file utility program which loads files 
from an archive file onto a permanent file device. PFLOAD 
may be called by the permanent file supervisor -Csee Section 
or by a control card in the following format: 

PFLOADCplipSi. •.-ipnl 

The parameters-! described in Section 3.fl.5i are in the 
keyword = value format. 
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3»fi«3»S The following parameters are valid for PFLOAD- 
FN * family name 
PN * pack name 
DN = device number 
T = archive file name 
LO = List Options 

T - Catalog of loaded files. 

C - Catalog of catalog image record. 

E - Errors. 

L = output file nane 
OP * Utility Options 
C - Creation 
A - Last Access 
n - Last Modification 
I - Indirect 
0 - Direct 

B - Before Date and Time 
R - Replace 
N - Noninitial 
NR No Rewind 

NU No Unload 

SF = n Cskip n files! 

N = n {number files to process! 

DT = yymmdd where yy=year mm=month dd=day 
TM = hhmmss where hh=hour mm=minute ss=second 
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UI ® user* index 
PF * permanent file name 
DI = destination user index 
DD = destination device 
UN = user number 

3»fl»3.3 Default Values 
FN = D 

PN = no name 
DN = 0 
T = Tape 
LO = 0 
L = Output 
OP = 0 

NR = not set 
NU = not set 
SF = 0 
N =0 
DT = 0 
Tfl = 0 
UI = 0 

PF = no name 
DI = 0 
DD = 0 

UN = no name 
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3*A*3«N Incremental load is performed by reading the catalog image 
record <CIR> from the most recent selective PFDUHP {first 
reel of incremental load process! and placing it on a random 
file. Each item in the CIR representis a file at the time of 
the selective dump, lilhen reading an archive filen if a match 
is found on the CIRi the file may be loaded and the item is 
cleared out of the CIR. If no matchi the file is skipped 
because it has been either purged or previously loaded* 


3.fl.3.5 Noninitial load reads catalogs for files existing on permanent 
file system and checks archive catalog for duplicate file. 

If file already existsi the archive file is skipped. If noti 
the file is added to the catalog and the data is stored. 

This process may be reversed by specifying the »R* utility 
option •COPs'R! in which case an existing file would be purged 
and the archive file would be added. 


Each time PFLOAD reads a catalog track where an archive file 
will reside 1 an index file is built containing the following 
information. 


ST 


3S 


file name 


17 


user index 


To determine whether a file will be loadedi the following 
procedure will be followed.* 


* Note: See Section B.fl.T.T for example of selective dump and incre¬ 
mental load. 
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I 1* If incremehtal loadn the file on tape must 

be in the catalog image record to cause file to be a 
candidate for load« Otherwisei the file on tape is 
skipped. 

a. Since many parameters can be selected for ioadi if a 

file is a candidate for load it will be checked against 
those parameters selected -CUIi PF-» UNi etc.>. If it 
meets these criteria it is still a candidate for load. 
Otherwise the file on tape is skipped. 

3. A directory is built by PFLOAO containing information 

about all files currently in the PF system. If the file 
is a candidate for load {as determined in 1 and 5> that 
already exists in PF system-i the file on tape is skipped. 

The only exception is if the R option is selected and the 
file is a candidate for load. Then the file in the PF 
system is purged and the file from tape is loaded. If 
the file is a candidate for load {as determined in I and 
8} that does not already exist in the PF system and R is 
not selected 1 the file from tape is loaded. 

3.A.3.(9 Tape errors may be encountered when loading a file. This 

could be caused by an error when writing the tape {PFDUHPl or 
reading the tape. Such things as dropped records or parity 
errors could cause this. If tape errors are encountered they 
are processed by writing an EOF and the length specified in 
the catalog is updated to reflect the proper length of the file. 
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3«fi*3*7 Non-Fatal System Error Messages 

These errors result in the file being processed to be skipped 
on tape and not loaded* 

» CATALOC CONTROL UORP fllSSINS.* 

Encountered other than catalog control word on initial control 
word of archive record* 

» PERMITS PRESENT THAT SHOULD NOT BE.* 

Permit block found on tape but no previous permit random 
index found in catalog* 

* PERMITS MISSING.* 

No permit block present but there was a previous permit 
random index in the catalog or when entire permit block not 
read up yet and next word is not a permit control word. 

* NO DATA BLOCK.* 

Encountered other than data control word when expecting data 
for current file* 

* MISSING EOR.x 

Logical EOR missing - invalid data* 

» NO EOI FOR FILES.* 

Next catalog found before physical EOR found for current file. 

» PARITY ERROR ^filename* »user index** 
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j * TAPE ERROR »filename» »usep index** 

Issued when certain of preceding errors occur•« file is noted 
and skipped 1 and loading is resumed* 

* TAPE PARITY ERROR.* 

Parity error encountered•» file name unknown•» tape skipped to 
next COR* 

3*A*3*8 Fatal System Error Messages 

These errors result in PFLOAO being aborted* 

* NO USER INDEXES ON TAPE MATCH DEVICE MASK.* 

* ILLEGAL CATALOG TRACK COUNT** 

* ERROR IN CATALOG IMAGE ON FFDUMP TAPE.* 

* PARITY ERROR IN CATALOG IMAGE RECORD** 

* ANY LOADING TO THIS POINT* 

* INCOMPLETE - A REINITIALIZE* 

* AND RELOAD IS REflUIRED-* 

* PFLOAD ABORTED** 

* DEVICE SPECIFIED NOT FOUND** DN specified not defined in 
system* 

* NO PF DEVICE IN EST** No permanent file device is specified* 

3*8*3*T Informative Operator Messages 

* PFLOAD yy/mm/dd* hh*mm*ss** 

Tape label information* 

* PFLOAD REEL XX DEVICE xx^ 

* LOADING **File name^ ^jcyser index^^^JK Identification displayed 

of current file being loaded- 

* Information from label generated by PFDUMP*. 
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* P. F. I>CVICC «clevicenumber« LOADED.»: 

* WAIT FOR TOTAL INTERLOCK.* Total interlock being set or 
cleared. 
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3»6«3*10 Operator Messages which require action 

* NO TAPE LABEL.* 

» TAPE LABEL II> ERROR.* 

* REEL SEQUENCE ERROR.* 

* LABEL ]>ATE ERROR.* 

* LABEL TIME ERROR.* 

* MOUNT REEL NUMBER x * 

* FORMAT ERROR.* 

The action to be taken for the above situations is to make 
sure a dump tape is being assigned and that the proper label 
information being requested is in the label. This is label 
verification on the label generated by PFDUMP. 


AA 3777 


nUNTStMUSA. 



CONTROL DATA CORPORATION 

___DIVISION 

DOCUMENT CLASS_____£?.I__ PAGE Mn HI ^ 

PRODUCT NAME _ KRONOS a. j, ____. 

PRODUCT MOnPi Kin. E066*5«l MArmsif: 5 FRip<f CYBE!R TSt? 37^ 

3#6»M PFDUflP “ Permanent File Dump Utility 

PFDUMP is a permanent file utility that copies files stored 
on a permanent file device to a backup storage file* Files 
created by PFDUflP may be reloaded by the PFLOAD utility 
program* 


3.fl.M*2 Called by PFS {see Section.3*6*1> or control card in the 
following formats 

PFDUflP-CplipBi* * * ipn> 

The parameters 1 described in Section 3*fi*2-i are in the 
keyword = value format* The following parameters are valid 
for PFDUnP* 

FN = Family Name 
PN = Pack Name 
DN = Device Number 
T = Archive File Name 
LO = List Options 

T - Tape Catalog 
C - Catalog on device 
E - Errors 

L = Output File Name 
OP = Utility Options 
C - Creation 
A - Last Access 
H - Last flodification 
I - Indirect Access 
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1> - Hrect Access 
B - Before Date and Time 
p - Purge After 
NR - No Rewind 
NU = No Unload 
SF = Number of Files to Skip 

DT = Date - yymmdd where yy“yearn mm=monthn dd“day 
TM = Time “ hhmmss where hh=hourn mm-minuten ss=second 
UI “ User Index 
PF = Permanent File Name 

V = Verify Archive File {see PFS section for description! 
UN = User Number 
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Default Values 
FN = SYSTEM 
PN = no name 
DN = 0 
T = TAPE 
LO = 0 
L = OUTPUT 
OP = 0 

NR = not set 
NU = not set 
SF = 0 
DT = 0 
TM = D 
UI = 0 

PF = no name 


V = not set 
UN = no name 
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3*6*M*M If no options are selected -COP = 0 and DN = 0 or DN = Master 
Device! then the dump is considered a full permanent file 
system dump* 

If any option but OP = M is selectedi then the dump is con¬ 
sidered a partial permanent file system dump* 

If modification date option is selected -COP = M}-i then the 
dump is considered a selective permanent file system dump* 

Selective dumps are intended to be used for incremental load* 

At the beginning of each selective dump file are recordls! con¬ 
taining catalog images of all files active in the permanent 
file system when dump took place* This allows maintenance 
either on a device type basis or system basis* To increment- 
ally loadi the initial tape assigned must be the most recent 
selective dump tape* Many archive files may be loaded 
{selective or not! following the first selective file-> 
properly loading any part or the whole permanent file system 
as desired* 

Example: 

Device MO = Master Device {contains only indirect files! 

Device Ml = Master Device {contains direct and indirect files! 
Device M5 = Non-Master {contains direct files! 
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A.n. 


flonday 

"Pump A" 

full dumps 
of devices 
<will include 
files on ^a> 


selective dump 
of MQ-. m-i & M2 
separately 


Tuesday 

"Pump E" 

selective dump 
of whole system 
•CMD-. m-. M2} 


selective dump 
of ME only. 


Wednesday 

"Pump 6 a H" 

selective 
dumps of MO 
and Ml 


"Pump I" 

selective 
dump of MOt 
M il ME as of 
current time. 


P.n. "Pump B-i Cl a P" "Pump F" 


Let's suppose Pevice ME goes down before dump I is taken and 
direct access files on that device are to be loaded from 
archive files - first Pevice ME must be initialized. Archive 
dump H contains the most recent CIR. It is loaded first. 

Only the CIR is loaded as none of the files on H are to go to 
Pevice ME- Then dumps Ft Et Pi and last the archive dump A 
are loaded. By loading the archive dumps Hi Ft Et Pt A — 
in that order t the most recent copies of files on Pevice MB 
will be reloaded and duplicate copies will be skipped -Csee 
Section 3.6.3.M}. 


Another method might be used if the dump of Pevice ME on 
TuesdayT P.fl. specified device number MB with OP = 0 
■CPFPUnP-CPN = MB}}. This is not a selective dump {no CIR writtenli 

so on Wednesday when Pevice MB goes down a selective dump of 
the whole system must be taken for all files modified in the 
last one secondT yielding a file {Pump 1} containing only a 
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catalog image record to serve as the first reel of an incre¬ 
mental load* After dump I is taken n initialize Device MS* 
Then dump I is loaded followed by dump F which contains all 
files on Device MS as of Tuesday-i p.(1* This will load copies 
of files as of dump F for Device MS except those files purged 
since dump F* 

To restore Device Ml on Tuesday t P.fl* after the dump F has 
been takeni initialize Device MIt then incrementally load 
I Device Ml starting with dump F* Note: Only those files will 

be loaded whose catalogs reside on Device Ml* Then load dump 
I El Di Ct B and A* This will restore all files residing on 

Device Ml and all files on other devices whose catalogs 
I reside on Device Ml* 
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The following table illustrates how direct access files are selected 
for dumping when modification date and time are specified* 


MODIFICATION 

DATE 

CURRENT 

ACCESS 

CATALOG 

AFTER 

REQUESTED 

DATE 

CATALOG BEFORE 

REGUESTED DATE 

SYSTEM SECTOR 
AFTER DATE 

SYSTEM SECTOR 
BEFORE DATE 

NONE 

DUMP 

DUMP 

NO DUMP 

READ 

DUMP 

DUMP 

NO DUMP 

WRITE 

NO DUMP 

NO DUMP 

NO DUMP 

MODIFY 

APPEND 

DUMP 

DUMP 

DUMP 
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3*6*M«5 Permanent file system dumps requesting a catalog image record 
to be generated 1 require an idle system* This means that 
PFDUHP sets the total interlock for a device before the catalog 
image record is generated. Permanent file device total 
interlock will not be cleared until the catalog image record 
has been completely generated! at which time the criteria of 
the next section is followed. 

B.fi.M.b All permanent file system dumps do not require an idle 
system-i except for the case mentioned above. Howevern 
certain restrictions are placed on users whose catalogs 
reside on the catalog track currently being dumped. While 
a catalog track is being dumpedn a certain portion of the 
catalog track is read and a read list generated for those 
catalogs that are active. Upon completion of the dumping 
of these files and before reading more catalog entries! the 
catalog track interlock is cleared and a pause is taken to 
allow PFM to perform a function using that catalog track. 

The catalog track is then interlocked by PFDUHP again and 
more catalogs are read until done with the track. 

3.6.M.? Informative Operator Messages 

* P.F. DEVICE *devicnm» DUMPED.* 

* PACKNAME *pknm* DUMPED.* 

*DUMPING *filename* *user index** 

*PFDUMP yy/mm/dd. hh.mm.ss.* 

* *PFDUMP REEL nn DEVICE xx* 
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* * PFDUMP DEVICE MASK xxx** 

* DUfIPINe - DIRECT ACCESS FILES ONLY.* 

* DUflPING - INDIRECT ACCESS FILES ONLY.* 

* FILENAME xxxxxxx USER INDEX xxxxxx* 

* ALL FILES FOR USER INDEX xxxxxx* 

* ACCESSED AFTER yy/mm/dd. hh.mm.ss.* 

* CREATED AFTER yy/mm/dd. hh.mm.ss.* 

* MODIFIED AFTER yy/mm/dd. hh.mm.ss.* 


Operator Messages that require action 

* ASSICN REEL NUMBER *reel number** 

* INCORRECT REEL MOUNTED* 


3.6.M.*) System Error Messages that are Fatal 

These errors result in PFDUMP aborting* 

* CATALOC INDEX OUT OF RANGE.* 

Catalog buffer location not in buffer range. 


» See Operator’s Guidei pages 7-1 and 7-2 
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3*a.M»10 System Error Messages which are Non-Fatal 
^ STATUS ERR »filename» ii^user index^t:^ 

Bad ordinal or status for a direct access file - file skipped. 

* INDIRECT TOO LONG >gfilename* *user index*^ 

File truncated. 

* INDIRECT TOO SHORT ^filename* »user index** 

File padded with EOF's. 

* DIRECT TOO LONG ^filename* »user index** 

File truncated. 

* DIRECT TOO SHORT ^filename* »user index** 

File padded with E0F*s. 

* DAF BUSY ^filename* »user index»» 

File skipped. 

* DAF ZERO LENGTH ^filename* »user index** 

File skipped. 

* SYSTEM SECTOR BAD ^filename* »user index»» 

File skipped. 
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Catalog Image Record -CCIRl 
S*1 M7 M 

Permanence File Name 


17 


Device 

Number 


Access 

Count 


t: 


User Index 


Last Access Date 8; Time 


There is 1 entry for each file on the catalog. 


Catalog Image Record Directory 

ST 2T 

HEAD Total number of files 


TRKN Number files on track 


Random Index to 
Catalog Record 



HEAD - is a header indicating the total number of files on 
the permanent file system. 

TRKN - is the table entry for one catalog track of device. 
There may be up to SQO of these entries. 
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3.fl«S PFCAT - Catalog Permanent File Device 

PFCAT is a permanent file utility program which catalogs 
permanent file catalog tracks and generates a report. The 
possible reports are: 

1. Listing of catalog file with files grouped by user index. 

2. Statistical report of device usage. 

3.fi.5.2 PFCAT may be called by the permanent file supervisor {see 

Section 3.a.l> or by a control card in the following format: 
PF CA T{plTp2 T...ipnl 

The parameters 1 described in Section 3.fi.Ei are in the 
keyword = value format. The following parameters are valid 
for PFCAT. 

FN = Family Name. 

PN = Pack Name. 

DN = Device Number. 

LO = List Options 

T - Catalog of files processed by user index. 

E - Errors. 

S - Statistical Summary. 

L = Output File Name 
OP = Utility Options 
C - Creation 
A - Last Access 
n “ Last Modification 
I - Indirect 
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D - Direct 

6 ** Before Date and Time 

DT = Date yymmdd where yy*yeari mm=monthT dd=day 

TM = Time hhmmss where hh=houri mm=minutei ss=second 

UI = User Index 

PF = Permanent File Name 

UN = User Number 

3-a*5>3 Default Values are: 

FN = SYSTEM 
PN = no name 
DN = 0 
LO = D 
L = OUTPUT 
OP = 0 
DT = D 
TM = 0 
UI = Q 

PF = no name 
UN = no name 
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3«fl«S»M System Error llessages 

* PFCAT COMPLETE.* 

Catalog of permanent file device completed. 

« EQUIP. NOT IN PFCAT TABLE.* 

There is no entry in PfCAT*s tables for the equipment type 
being cataloged therefore no percent device usage can be 
determined. 

» INDEX BUFFER LIWIT.* 

♦INDBL* -CIndex Buffer Length! must be increased to accommodate 
all user indices on a catalog track. 

» DEVICE ERROR.* 

Not a master device. 

» ILLEGAL DEVICE NUMBER.* 

Device number for alternate device not defined. 

» MASTER DEVICE NOT FOUND.* 

Master device not defined in system. 

B.fl.S.S Operator Messages 

* CATALOGING »user number* *user index*.» 

Identification of user number being cataloged. 


* CATALOGING COMPLETED.* 
Informative. 
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* URITIN6 SUf1f1ARY»» 
Informative. 
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3*fl»b PFATC “ Catalog PF Archive Tape 

3*&«b«3i PFATC is a permanent file utility program that catalogs 

archive tapes* PFATC may be called by the permanent file 
supervisor -Csee Section 3.fl.l> or control card in the 
following format: 

PFA T CCplip5 T • • • 1 pnl 

The parameters 1 described in Section 3.6.Si are in the 
keyword = value format. 

3*6*b.S The following parameters are valid for PFATC. 

T = Archive File Name 
LO = List Options 

T - Tape Catalog 
C - Catalog of Catalog File 
E “ Errors 

L = Output File Name 
OP = Utility Options 
C - Creation 
A - Last Access 
M - Last Modification 
I - Indirect 
]> - Direct 

B - Before Date and Time 
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NR = No Rewind 
NU = No Unload 
SF = Number of Files to Skip 
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N * Number of Files to Process 

DT * Date yymmdd where yy=yeari mm=month-i dd=day 

TN ® Time hhmmss where hh=hour-i mm=minuteiss*second 

UI = User Index 

PF = Permanent File Name 


3*a>b*3 Default Values 
T = TAPE 
LO = 0 
L = OUTPUT 
OP = D 

NR = not set 
NU = not set 
SF = 0 
N « 0 
DT = 0 
Td = 0 
UI = 0 
PF = no name 
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System Error Messages 


» PFATC ABORTED.* 

If error flag is set. 

3.fi.i3.S Operator Messages 

*CATALOSING ^filename* *user index** 

Identification of current file being loaded. 

» MOUNT REEL NUMBER _n* 

Reel *n* of series of archive files should be assigned in 
order to proceed. 

♦NRONG REEL MOUNTER.* 

Reel mounted is not next sequential reel in series if archive 
tapes being cataloged. 

*N0 TAPE LABEL.* 

No valid PF label found at beginning of reel. 

* PARITY ERR ^filename* »user index** 

Parity error on file ^filename*. 

* TAPE PARITY ERROR.* 

Parity error detected reading archive file. 

» CATALOGING COMPLETED.* 

PFATC complete. 
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3.fl.7 PFCOPY - Copy Archive File Utility 

3*6*7«1 PFCOPY is a permanent file utility program that extracts 
files from an archive file and copies them to one or more 
files. 

3.fi.7.2 PFCOPY may be called by the permanent file supervisor {see 
Section 3.fl.l> or a control card in the following format: 
PFC0PY{pl-.p2-....-,pn> 

The parameters 1 described in Section 3.a.2i are in the 
keyword = value format. The following parameters are valid 
for PFCOPY. 

T = Archive File Name 
LO = List Options 

T - Tape Catalog 
E “ Errors 

L = Output File Name 
OP = Utility Options 
C - Creation 
A - Last Access 
N “ Last Modification 
I - Indirect 
0 - Direct 

B - Before Date and Time 

Q - Preceed with catalog and permit records 
NR = No Rewind 
NU = No Unload 
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SF * Number of Files to Skip 

N » Number of Files to Process 

DT = Date yyimndd where yy=yeari mm=month-» dd=day 

Tfl = Time hhmmss where hh=houri mm^minutei ss=second 

UI = User Index 

PF = Permanent File Name 

fIF = Plaster File Name 

3*6.7.3 Default Values 
T = TAPE 
LO = 0 
L = OUTPUT 
OP = 0 

NR = not set 
NU = not set 
SF = 0 
N = 0 
DT = □ 

TPl = 0 
UI = 0 

PF = no name 
MF = no name 
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3.fi.7.M Operator dessages 
* END OF COPY.* 

Program complete. 

I ^READING *filename» *user index^^tc 

^COPYING *filename» »user indexT» 

3.fi.7.S Oayfile Messages - System Errors 


* TAPE PARITY ERROR.* 

Parity error encountered! file name unknown! tape skipped 
to end-of-file -CPHYS- E0R>. 

* PARITY ERR ^filename* »user index»» 

Parity error on file ^filename*! file is skipped and execu¬ 
tion resumed. 


* CATALOG CONTROL UORD MISSING-* 

Catalog control word expected but not found. 

* ASSIGN REEL NUMBER _n_£ 

Archive tape number *n* needed to be assigned to job. 

* INCORRECT REEL REASSIGN.» 

Reel assigned is not proper reel in sequence. 
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* PFCOPY ABORTED.* 

PFCOPY has encountered CP error. 


AA 3777 


PRINTED IN U&A. 



CONTROL DATA CORPORATION 


DIVISION 


DOCUMENT CLASS———£55__ PAGE NO._H± 1-9_ 

PRODUCT NAME _ KRONOS S. 1 ___ . 

PRODUCT MODEL md £066*5.1 _ MACHINE cfrif*; bOOD/CSC CYBER .75.-i7 3-.7H 

3.T PF Utilities General Information 

3»T.l Low Core Retrieval Functions 

It is necessary in terms of time and space to add a function 
to the system to retrieve central memory resident information 
for CPU programs. Such information as the equipment status 
table pointer CESTPln the equipment status table entries CESTli 
and the mass storage tables -CMSTl are required by PFLOADn 
PFDUMP and PFCAT to successfully process a system of permanent 
files as opposed to singular devices. This also eliminates 
more special functions which would have to be added to PFU- 
This feature will be available to system origin users. 

3.T.2 Catalog Image Entry Information 

Format ST ^7 3S 17 0 


Permanent File Name 

User Index ; 

Device 

Number 

Access 

Count 

Access Date 

& Time 

i 


The first word of the entry describes the file uniquely in the 
system. The second word contains device number Cdirect access 
files onlyli access counti and last access date and time. When 
a file is loadedi this information is placed in the catalog of 
the file as it is the most current information available for 
that file. No other information can be changed over dumps and 
loads without modification date and time being updated. 
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Catalog image records are separated by a physical EOR on the 
archive file* This provides some protection due to parity 
errors in reading the catalog image record. Uhen a parity 
error is detected in reading a CIR the message is issued: 

PARITY ERROR IN CATALOG IMAGE - dm ct* 
and the operator may enter K.GO. or K.STOP. to indicate whether 
to continue the load process* 
dn = device number 

ct = catalog track Crelative to the start of catalog tracks} 

If he continues 1 files on this catalog track will be skipped-i 
and processing will continue with the next CIR* If he does 
not wish to continuei the program will abort* 
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M.O DEFINITIONS* 

N*! Indirect Access File 

Refer to Time Sharing User's Manual {page S-1}. 

Direct Access File 

Refer to Time Sharing User's Manual -Cpage S“l>. 

M.3 Catalog Track 

Every permanent file in the system contains a catalog entry 
specifying the characteristics of the filei access information 
about the file and the location of the file. The catalog entries 
are grouped together on catalog tracks on the permanent file 
device. The length of the catalog entry is fl words. The end of 
a catalog track is indicated by an EOI on the device. All 
catalog entries for a user reside on one catalog track. All 
catalog tracks are linked in the Track Reservation Table and 
appear as one logical chain. Iilhen a catalog track exceeds a 
logical track-i another track is allocated at the end of the 
catalog chain and the catalog track is linked on mass storage 
to the continuation catalog track. 


» Refer to Interchangeable Device ERS for additional definitions that 
may be helpful in this ERS. 


AA ^rn 


CONTROL DATA CORPORATION 

___DIVISION 

DOCUMENT CLASS_ PAGE NO.JL£I__2f_- 

PRODUCT NAME_ 

PRODUCT MODEL NO_MACHINE SERIES- 

M.M User Croup 

Catalog tracks are allocated such that each track contains a 
specific user group consisting of a group of user indices** The 
number of catalog tracks allocated for a device specifies the user 
indexes within a user group. Uhen permanent files are accessedn 
the user index specifies the catalog track and device ihich 
contains the users catalog entries. PFM will search only this 
catalog track to satisfy the PF request. 

^.5 Indirect Access File Holes 

Because the system allocated mass storage space on a logical 
track basis 1 PFd must do some of its own allocation to handle 
the sector by sector allocation required for indirect access 
files. They are allocated in this manner because experience 
indicated the average file size for most terminal users to be 
somewhat less than a logical track.** All the indirect files 
for a device are represented within the system by one logical 
track chain. Catalog entries point to specific areas within this 
chain which contain the indirect access file. Whenever a file is 
purged 1 the only indication of the space being available for 
allocation is the "deleted” catalog entry. The space cannot be 
released for system allocation unless it is greater than a logical 
track in size. This "deleted" catalog entry represents an indirect 

* Refer to Operator's Guidei page 7-1 for further description of 
user index. 

*♦ Logical track size varies with device type, i.e.i fiOfi^SQ sectorsi 
flm-M=155 sectors 1 etc. 
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access file hole* A catalog track then-i contains not only catalog 
entries for a user groupi but also pointers to holes within the 
indirect access file chain created by PF activity of this user 
group. 

M.b Dedicated Device 

A dedicated device is a mass storage device which is dedicated to 
the allocation of indirect access files and catalog entries. No 
direct access permanent files may reside on this type of device. 

M.? Interlock 

Because several PFM requests may be in process simultaneouslyi 
some interlocks are necessary to insure that requests on the same 
file or catalog track do not overlap. As an examplen consider 
the following: User A retrieved file Xi user B purged file Xi 
user C saves file Y which is placed in the hole where file X 
resided. If user A*s request Igeneration of a working copy of X> 
was not completed before user's C request was completed and no 
interlock was performedi user A might end up with some data from 
file Y. Several types of interlocks are necessary for permanent 
file access. 

M.7.1 Device Interlock 

There are certain situations when the entire device should be 
interlocked to insure a particular operation will be successfully 
performed. An example of this might be a full dump of permanent 
files. 
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Catalog Interlock 

Because all requests for a user must search a particular catalog 
track the type of problem specified above can be avoided by 
interlocking the catalog track. This prevents the problem of 
overlapping requests on the same file while at the same time 
allow users of another user group {catalog track! to access 
their files* 
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APPCN1>IX A 

PERMANENT FILE UTILITY K-DISPLAYS 
•CLEFT AN1> RIGHT DISPLAYS^ 


PF Utilities Left K-Display 

**» PERMANENT FILE UTILITY OPTIONS *** 


OPTION 

CURRENT 

VALUE 

DESCRIPTION 

UT 

s 

0 

UTILITY DESIRED 

1 FN 

s 

UNDEFINED 

FAMILY NAME 

PN 

s 

0 

PACK NAME 

DN 

s 

0 

DEVICE NUMBER 

T 

s 

TAPE 

ARCHIVE FILE NAME 

LO 

= 

0 

LIST OPTION 

L 

s 

OUTPUT 

OUTPUT FILE NAME 

OP 

s 

□ 

UTILITY OPTION 

NR 

- 

0 

NO REWIND 

NU 

= 

0 

NO UNLOAD 

SF 

s 

0 

SKIP FILES 

N 

• 

0 

NUMBER OF FILES TO PROCESS 

DT 

s 

D 

DATE YYMMDD 

TM 

= 

0 

TIME HHMMSS 

UI 

= 

0 

USER INDEX 

PF 

= 

0 

PERMANENT FILE NAME 

MF 

s 

□ 

MASTER FILE N^ME 

UN 

1 

V 

s 

D 

USER NUMBER 

s 

0 

VERIFY ARCHIVE FILE 

DI 

= 

0 

DESTINATION UI 

DD 


□ 

DESTINATION DEVICE NUMBER 

DATE YY/MM/DD. TIME HH.MM.SS. 

REEL N 

FILE USER 

NAME INDEX 

•CMessage line! 

■Cist Error line! 

{2nd Error line! 


I {Entered parameters! 

The message line is used to display status messages such as LOADING 
filenam userim CATALOGING filenam userin-» etc. The error lines are 
used to display error messages or operation requests. Two lines are 
provided to facilitate error message plus action to be taken. 

♦ This name will be derived from the system as the family for the 
current P.F. System. 
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PF Utilities Right K-Display 

♦»» PERMANENT FILE UTILITY OPTION DESCRIPTION *** 

OPTION DESCRIPTION 

UT FUTILITY* *LD» - PFLOAD 

*DU* - PFDUnp 
*CA* - PFCAT 
*AT* - PFATC 
*CP* “ PFCOPY 

LO »LIST OPTION* T - TAPE CATALOGS 

C “ PERMANENT FILE 
DEVICE CATALOGS 
E - ERRORS 
S - SUMMARY 

OP ^UTILITY OPTIONS* C - CREATION* 

A - LAST ACCESS* 

M - LAST MODIFICATION* 

I - INDIRECT ACCESS** 

D - DIRECT ACCESS** 

B - BEFORE 

P - PURGE AFTER DUMP 
R - REPLACE 
N - NONINITIAL LOAD 
a ‘ ADD CATALOG AND PERMIT RECOVERY 

NOTE: OPTIONS ENTERED AS FOLLOWS: 

K.LO = TCS 

OR 

K.OP = CIBP 

* ONLY ONE TYPE OF DATE MAY BE SPECIFIED. 

** ONLY ONE ACCESS OPTION MAY BE SPECIFIED. 
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1-0 SCOPE 


1*1 This specification defines the external features of the inter 
active communications subsystem of the KRONOS 5*1 Operating 
System■ 
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3.0 


APPLICABLE DOCUMENTS 

KRONOS H.l Product Objectives Document 

KRONOS 5.0 Batch User’s Reference Manual 

KRONOS 2.0 Time Sharing User’s Manual 

KRONOS 5.1 Transaction Subsystem Standardization ERS 

KRONOS 5.1 User Profile Control ERS 
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3.0 DESCRIPTION 

3.1 Time Sharing Communication Enhancements 

Enhancements which provide new features and more flexibility to 
the communications subsystem are as follows* 

Extensive control of the terminal by an Interactive CPU program. 
Support of a wider variety of terminals. 

Provision for future enhancements. 

3.1.1 Terminal Protocol 

Terminal protocol is defined to be that series of operations 
which the computer must perform to successfully operate the 
terminal. The terminal subsystem will provide for S proto¬ 
cols • The protocols provided will support terminals as 
follows* - 

ASCII code terminals such as 

TELETYPE Models 33-. 3S-. 37-, and 38 
CDC 713 
HEMOREX IBMO 

Correspondence code terminals such as 

IBM 27m 
NovAR sm 
DATEL 30 

NOTE: Operation of correspondence code terminals requires a 
i?SE to the bb7b or bfeiTl multiplexer. A (3SE is also 
required for line speeds other than ten characters per 
second. 


AA 3777 



CONTROL DATA CORPORATION 


DIVISION 


DOCUMENT CLASS__ PAGE NO._ 11 _H__ 

PRODUCT NAME_ KRONOS E.l _, ___ ^ 

PRODUCT MOnPi Kin. E066*g.l MArHiNF -iTM 

3*1‘I*! Terminal Identification 

The terminal network file -Csee KRONOS Transaction Subsystem 
Standardization ERS> can designate certain ports for ident¬ 
ification of the terminal type by the first character re¬ 
ceived* Thus-i on these portsi the user must initiate his 
terminal session by depressing the key on his terminal 
specified by the ID Code in Appendix A• A correspondence 
code terminal must be used on such a port* 

3*1*5 Code Conversion 

To provide for the usage of printing elements which differ 
from the standard for the terminali the terminal system will 
include M translation tablesi listed in Appendix Ci and the 
facility for 56 additional ones * A translation table may be 
selected in one of the following ways* 

The terminal identification codes as above 'C3*l*l*l>* 

A system command {TERM!* CSee Section 3*l*l>> 

A parameter defined in the user validation file* CSee 
User Profile Control ERS> 

3*1*3 Input Processing 

3*1*3*1 Input Control Characters 

Certain terminal codes are used to provide control of the 
input from the terminal * These codes are recognized in 
normal and ASCII input conversion modes only Csee Section 
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3•1*3*2 and 3»l-3-3>* The following list defines the 
control operationsi and the associated terminal codes are 
listed in Appendix A• 

RETURN 

Terminate current input line with END OF LINE code* 

DELETE 

Discard current input line* The system responds with 
the message 4(DEL** 

BACKSPACE 

Discard previous character entered* 

STEXT 

Begin text mode entry for creation or editing of the 
user*s Primary file* 

ETEXT 

Terminate text mode* 

NOTE: STEXT and ETEXT are recognized only when source 
input is allowed* 
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3«1*3«S Normal Input Code Conversion 

The normal input conversion selected when the user is 
logged into the system converts input data to b bit internal 
code -Csee Appendix C>* Lower case alphabetic characters 
are converted to upper case. All characters not defined 
in the b bit internal code and the line feed are ignored. 
Alsoi the input control codes -Csee Section 3.1.3.1> are 
not translated. 


3.1.3.3 ASCII Input Code Conversion 

The ASCII input conversion may be selected by user command 
■CASCIII. This action causes the driver to translate all 
characters to the b/12 bit* internal codes -Csee Appendix C>. 
The LINE FEED and ASCII-DEL codes are ignoredi and the input 
control codes -Csee Section 3.1.3.1> are recognized but not 
translated. 


3.1.3.M Transparent Input Code Conversion 

The transparent input conversion may be selected by an 
interactive program -Csee Section 3.1. M.3}. This mode 
causes the driver to translate as in the ASCII mode but no 
characters are ignored. In additioni no Input Control 
Characters are processed^ ratheri all characters are passed 
to the program as data. INTERRUPT is passed as a NULL follow¬ 
ed by an END OF LINE. RETURN is passed as an END OF LINE. 

» NOTE: b/ia bit codes refers to the escape code convention wfiich 

allows an extended character set -Cmore than ba characters!. Internal 
display code characters are preceeded by 7b or 7*4 octal codes to 
indicate extended characters. -[See Appendix C.> 
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3*1«3>5 Binary Input Conversion 

Binary input conversion may be selected by user coimnand 
iBINARY> or by an interactive program {see Section 3.1.b 
or 3«1.M.3>. This input mode packs the fl bits of data as 
the bottom 6 bits of a IS bit bytei with the upper bit {11> 
being set- The user specifies a character count and/or a 
termination code to define the END OF LINE. The exhaustion 
of the character count or the occurrence of the terminator 
code will cause the END OF LINE to be set. The line is 
preceded by the binary output control byte {0007> which 
indicates that the data is binary. 

Example 

TTY input: 

BINARY iS 
ABCD @ 

Source file: 


1st 

cm word 

ODD? 

moi 

mos 

H303 

moM 

Snd 

cm word 

MSIS 

0000 

0000 

0000 

0000 
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3*1•3-b Interrupts 

The INTERRUPT key from the terminal is indistinguishable 
from a character of all zeros due to the design of the bb7X 
multiplexers• This key is defined in Appendix A• 

The processing of INTERRUPT is dependent upon the particu¬ 
lar activity in process at the time of the entry* The 
processing is described in Appendix B * 

The actions are summarized below: 

During output - acts the same as "I" key** 

Empty input line - interrupt running program* 

•Clf a program is in execution-i INTERRUPT acts the same 
as the "I" key during output *> 

Non-empty input line - 

a* Normal input conversion mode - ignore INTERRUPT, 
b* ASCII input conversion mode - translate INTERRUPT 
to NULL* 

c* Transparent input conversion mode - translate 
INTERRUPT to NULL followed by an END OF LINE* 
d * Binary input mode - store at least one zero code 
{NDDD octal in a byte> and possibly one or two 
extraneous characters * 


* See Time Sharing Users Manual for description of "I” key* 


AA 3?T7 



CONTROL DATA CORPORATION 


DIVISION 


DOCUMENT CLASS_ 

PRODUCT NAME_ 

PRODUCT MODEL NO. 




PAGE NO.. 


T Rev A 


MACHINE 


3«1«4 Output Processing 

Normal Output Conversion 

The normal mode of output conversion is to translate all 
b/12 internal codes to the correct code for the terminal* 


3«1.‘4.2 Binary Output Conversion 

Binary output is initiated upon the detection of the 
INITIATE BINARY OUTPUT control code {see Section 3.1.M.3>. 

The binary output mode continues until an END OF LINE control 
code is detected* 


3*1*M.3 Output Control Codes 

I Any output data for a terminal may contain output control 

bytes. An output control byte is a 12 bit byte right 
justified at bit positions 0-» 12i 2Mi 3ti and Mfl of a CM 
wordi with the upper b bits set to 0* Such a byte exer¬ 
cises certain control over terminal activity. An output 
control code which changes terminal input mode <0003-* 0005 1 
or 000b> will prevent the question mark normally output 
from being sent to the terminal. The control codes are 
summarized below. 


0000 END OF LINE 

This control byte causes the terminal to be positioned 
to the beginning of the next line. The remainder of the 
word in which the END OF LINE occurs is discarded. 
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0001 END OF BLOCK 

0002 END OF BLOCK {for compatibility with KRONOS 2.0> 

This control byte is used to terminate output before the 
end of the data buffer is reached. The remainder of the 
output data is discarded. A user program may replace the 
last END OF LINE byte with this code to prevent the terminal 
from being positioned to the next line. 

0003 AUTO INPUT 

This control byte is intended to be used by TELEX for auto 
mode input 1 but may be output by a user program. The word 
in which the control byte occurs is used as the first n 
characters of the input line, n must be even and less than 

T. 

OOOH LOG OFF USER 

This control byte disconnects the user's telephone lines. 

OOOS SET TRANSPARENT INPUT 

This control byte sets transparent input for the next 
input request. 

OOOt SET BINARY INPUT 

This control byte sets binary input for the next input 
request. The control byte must be the first byte of a word. 

The next 2 bytes are the termination conditions as follows: 
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The first byte -Cbyte 1> is the maximum number of 
characters to be received before the input is terminated. 

If the value is On 1 is assumed. 

The second control byte -Cbyte 5> is a termination code. 

Uhen a character is received from the terminal which 
matches the bottom fi bits of this byten the input operation 
is terminated. If bit 11 of this byte is setn no termina¬ 
tion character is assumed. 

A maximum of ISO binary coded characters can be input as 
data to an interactive program. 

0007 INITIATE BINARY OUTPUT 

This control byte initiates binary output. 

EXANPLE: 

The ASCII codes ABCOEFG may be output by writing the 
following CM words to the terminal output file -Csee 
Appendix C>: 

1st cm word 
Snd cm word 


0007 

. < 

moi 

. t 

moB 

. « 

4303 

moM 

M30S 

M30b 

mo 7 

0000 

0000 


AA 3777 




CONTROL DATA CORPORATION 


DIVISION 


DOCUMENT CLASS_£^5__ PAGE NO.-iJl!__ 

PRODUCT NAME_ KRONOS 5.1 _ 

PRODUCTMODPi NO. EDa6*5.1 MAruiMc ccbipc bPOO/CDC CYB£R 317M 

Special Processing of Internal Codes for Output 
EN1> OF LINE for ASCII terminals 
•Cl> Issue CR to terminal • 

■C5} Issue LF to terminal • 

■CBl If the user has not specified a delay character count 
by the "ROUT" command -Csee Section 3«l-b> or by the 

VALIOUS file parameter Csee the User Profile Control 
ERSli set n = 2- Otherwise^ set n •« user specified 
delay count* 

mi If terminal is not in tape modei issue n NULL codes* 
Otherwise-! issue n OEL codes* 

RETURN for ASCII terminals 
•Cl> Issue CR to terminal* 

-C5> If user has not specified a delay counti set n » 3* 
Otherwise-! set h = user specified delay count* 

<31 If terminal is not in tape mode-i issue n NULL codes* 
Otherwise-! issue n OEL codes* 


END* OF LINE for Correspondence code terminals 
■Cl> Issue NL to terminal * 

-C5> Issue LC to terminal* 

■G3> Issue n IL codes to terminal-i where h ■ character 
count of line divided by fi* 
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RETURN for Correspondence code terminals 

Issue n 6S codes to terminal-! where n is the number 
of characters on the current line. Backspacing to 
beginning of line is necessary because a RETURN causes 
paper advance as well as carriage return on correspondence 
terminals. 

LINE FEED for Correspondence code terminals 
•Cl> Issue LF to terminal. 

121 Issue IL to terminal. 

3.1.S User Processing of Terminal Interrupts 

Interactive user programs may override the terminal subsystem 
control of interrupts by means of a system request. The 
interrupt override provides the user program with notification 
when the terminal user enters an interrupt. The user program 
may select either of the following 2 methods for notification 
of terminal interrupts 

sets the low order bit in a program specified address 
within the user’s program. 

OR 

copies the program registers to a program specified 
address within the user’s program and changes the program 
address to the specified address plus twenty octal. 

For further explanation see Appendix B- 
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3»l.S.l INTERRUPT on Input Request 

No data is passed to the program and the input file status 
is set to END OF INFORMATION and the program is notified of 
the interrupt* 

3.1*5.a INTERRUPT During Output 

All currently accumulated output is discarded and the user 
program is notified. If the program has issued an input 
request at the time output is interrupted-i operation is 
the same as INTERRUPT on input except that current output 
is discarded. 

2.1.5*3 Interrupt During Program Execution 

The user program is notified of the interrupt. 

3*1.(a New Terminal Commands 
APL-it-iwww 

Selects the APL -CA Programming Language! interactive inter¬ 
preter. The interpreter selects transparent input {see Section 
3*1.4.3} for all input and disable terminal control {see 
Appendix B}. The optional parameter t specifies the terminal 
type as described in Appendix A and the optional parameter www 
specifies the workspace to be loaded* www is defaulted to 
APLLIBS* For further informationi see the APL Reference Manual* 


BINARYinnnniccc 

Select binary input mode for source data to be stored on 
Primary file. The character count is specified by nnnn and a 
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termination character by ccc. nnnn may be from 1 to *10*15. ccc 
is specified in octal and Must include all fl bits to be received 
from the terminal. 

EXAMPLE: 

BINARY-.aO-.207 

When 20 binary characters have been entered or the ASCII 
character BEL -Ca 207 octal code-i even parityl-i the binary 
input will be terminated. 
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FULL 

Enter ECHOPLEX mode* Each character received from the termi¬ 
nal will be echoed back to the terminal just as it is received* 
This mode is effective only for ASCII terminals that are 
capable of supporting full duplex* 


HALF 

Clear ECHOPLEX mode* 

ROUTmn 

Set character count delay after RETURN to nn* nn may be from 
0 to 5*1* If n is nulli a standard delay count will be set* 

TERMit 

Set terminal type to t where t is the terminal type as des¬ 
cribed in Appendix A * 


TEXT 

Enter TEXT mode* {equivalent to STEXT code as received from 
terminal!* 
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H.O GLOSSARY 

The names of characters used in this specification are capital¬ 
ized {denoting that it is a name! and are defined in Appendix Ai 
Appendix C-» or this glossary. This glossary defines special 
internal code namesi Appendix A defines control key names for 
most terminals {usually the name is the same as found on the 
terminal key capsJi and Appendix C cross references the terminal 
codes and internal codes and defines the code and key names# 


The following table defines the names of special internal codes. 


Name 

END OF LINE 

LINE FEED 
NEIi) LINE 

NULL 


RETURN 


A ction 

Termination of a message 
Implies NEtil LINE {see 
Sectzon 

Position to next line 

Position to start of 
next line 


Internal 
Octal Code 

□000a 


b? 

7b7b 


Output a nonprint character xxOOa 
{this allows a user program 
to position the terminal 
print mechanism at an odd 
column! 

On input 7bSS 

Position to start of line bb 


A Code must be byte a3.igned in central memory word {i.e.n the 12 bits 
must be positioned in a bO bit central memory word so that the 
right most bit of the 12 bit byte is in bit position 0i 12-. aMi 3b-. 
or Hfl of the central memory word>. 
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Appendix A 

Table of terminal types and associated control keys* 



ASCII 

Compatible 

MEMOREX 

12M0 with 
APL print 

Correspon¬ 
dence with 
Std* print 

Correspon¬ 
dence with 
APL print 

Typ««> 

TTY 

tlEHAPL 

COR 

CORAPL 

ID Code 

T 

n 

Attn 

A followed 
by Attn 

RETURN 

CR 

CR 

RETURN 

RETURN 

DELETE 

ESC 

ESC 

Attn«> 

Attn"^^^ 

BKSP 

UNDERLINE 

UNDERLINE 

BKSP 

BKSP 

STEXT 

STX 

STX 

nonetenter 
TEXT com¬ 
mand 

nonetenter 
TEXT com¬ 
mand 

ETEXT 

ETX 

ETX 

Attn^» 

Attn«> 

INTERRUPT 

BREAK 

BREAK 

Attn<» 

Attn*^^^ 


•Cl> Non-empty input line* 

•CSl Empty input line* 

•C3> Used with TERMit command -CB*!*!!! 
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APPENDIX B 
Terminal Control 

Very often programmers who write terminal application programs have 
a need to allow a program to "lock out" the terminal user during 
certain critical processes such as data base update* By locking out 
the terminal operator the program can prevent any of the normal 
terminal control commands from being processed by the system -CTELEXJ. 
This appendix will describe how terminal control normally works and 
how the feature to disable terminal control will effect the user at 
the terminal. 

Uhen a user has successfully logged into the KRONOS system■> the 
terminal can be in any of three modes. The mode that the terminal 
is ini controls the way the system processes terminal entries. 

These three modes are: 

Command llode 
Text Entry Mode 
Program Control Mode 

Command Mode 

When the terminal is in command mode the normal terminal commands 
I are accepted. These commands include subsystem designationi PF 
commandsi terminal control -CAUTOi ASCII>i job initiation CRUNli etc.* 

♦ See Time Sharing Usar’s Manual for complete description- 
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Whenever one of these commands causes output to the terminali whether 
it be a message*! report t or diagnostic-i the terminal can be considered 
under program control until the terminal ready indication is completed 
<REA1>Y in all subsystems but Batch which is />• Any lines preceeded 
by numeric characters are considered text and are accumulated in a 
file to be sorted later according to the line numbers- 

Text Entry Mode 

When the user desires to enter texti this can be done by entering 
the command "TEXT" or the STEXT key- In text mode all characters 
entered are considered data except ETEXT• 

Program Control Mode 

In the previous two modes the entries entered are pre-defined by the 
system {except for the content of the text>- The capability also 
exists to write programs in BASIC and FORTRAN which generage messages 
to the terminal and accept data from the terminal- In this mode*i the 
terminal can be in any of three states: 

Job Awaiting Input 
Job Currently Outputting 
Job Currently Executing 

In this mode only certain terminal entries are recognized and all 
others are either illegal or passed as data to the controlling program- 
The entries that are recognized from terminals areS 
an INTERRUPT or the commands STATUS or STOP- 
j The state of the terrrinal controls how these entries are processed* 
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^ J ob Awaiting Input 

whenever a program requests input from the terminal Cby reading file 
INPUT! the system outputs a at the terminal unless an output 
I control byte which changes input mode is detected first* The command 
STOP will cause the program to be terminated and the terminal will 
be placed in COnilAND mode* All other entries are passed as data to 
the executing program. A RETURN is passed as the end of line 
indicator -Cexcept in binary mode} andi if no data is enteredi a null 
input line is passed into the program* fSee Batch User’s Manual^ 

Chapter 7 for exact indication in programs data area}* 

♦Job Currently Outputting 

When the program generates output -Cby writing to the terminal output 
file} this is printed at the terminal whenever the program buffers 
require emptying {either because they are full or EORt EOF is written}* 

While the terminal is printingi the terminal operator can enter 3 
keys which will be recognized by the system*x 

S key causes program control to be terminated and the terminal 
to return to command mode {same as STOP in INPUT state}* 

I INTERRUPT causes the same action as I key* 


* NOTL! Sons correspondence code terminals will not allow any input 
except INTERRUPT during output or execution* 
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I key causes output to be suspended and the terminal is placed 
in suspended mode where the system will recognize: 

The *P* key causing return to program control discarding 
any output generated* NOTE: More output may be generated 
by the program but all data in program buffer when it was 
emptied previous to entry of the I key will be discarded* 

The ‘carriage return* causing output to be continued and 
program control to continue normally* Part of the current 
line of output may be lost when terminal output is suspended* 

Ti nnnn resets time limit to nnnn and continues job* This is 
meaningful only if Job has been suspended with message TIME 
LIMIT issued to terminal * Any other character causes program 
control to be terminated and the terminal to be returned to 
command mode* 

Job Currently Executing 

Uhile the job is executing-i the only entries recognized are: 

STOP to cause program termination and the terminal to return to 
command mode * 

INTERRUPT causes the same action as the I key during output* 
STATUS to cause system to list pertinent information about the 
program currently executing * 

* Reference Time Sharing User’s Manuali page 7-3* 
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The preceeding explanations describe the terminal users ability to 
control normal program execution- This allows the user to exercise 
control oven the pnogram during all phases of execution- As previ¬ 
ously mentioned-! certain applications may desire to prevent this 
total terminal control during critical processes- This is provided 
by user processing of interrupts•» referred to as the Disable Term¬ 
inal Control feature- The following describes how this feature 
can be used and the effect it has on the previously described situ¬ 
ations at the terminal- 


This control is activated by the program and therefore has meaning 
only while the terminal is in program control mode- The program 
can select either of two methods for being notified that the terminal 
user has attempted to terminate the program- He may specify an inter¬ 
rupt address to be used for either of the following: 

1> The location specified by the interrupt address within 
the users program will be set to a one- The program can 
then check this location periodically to see if terminal 
control has been attempted- 
Or 

5> The program operating registers will be copied to the SO 
octal words starting at the specified interrupt address 
and the program address will be changed to the specified 
address plus 50 octal - A system request has been provided 
to restore the operating registers so that normal program 
processing can be restarted after the special interrupt 
processing has been completed. 
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Once notification has been given when an interrupt address is specifiedi 
the interrupt address will be cleared and the program will not be 
notified of an attempted interrupt until the user program reselects 
an interrupt address. 

If no interrupt address is specified when DTC fOisable Terminal 
Control! is selected-! no notification of attempted terminal control 
will be given to the program. 

A macro has been provided for COMPASS programs to utilize the DTC 
feature. 

When the user program has activated OTC the following will occur 
for the three states of program control mode when the terminal user 
attempts control to terminal operation. 

Job Awaiting Input 

Control may be attempted by entering "STOP" except in binary input 
mode. No data will be passed to the program but the INPUT file 
status will be set to END OF INFORMATION and the program will be 
notified of attempted control if an interrupt address is specified. 

Job Currently Outputting 

The program will be notified of attempted control if an interrupt 
address is specified. If the program has issued an input request 
before terminal control is attempted-i the action taken is the same 
as for the job awaiting input. 
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Job Currently Executing 

Terminal control may be attempted by entering "STOP" or INTERRUPT. 

In either case the program will be notified if an interrupt 
address is specified* Otherwise the attempt will be ignored* 

The program terminal control statement may be released by three 
methods: 

1 * A system command issued by the program <a macro exist for 
this function!* 

I 2* Program terminates and terminal is returned to command 

mode* 

3* Terminal is logged out or disconnected -Cif disconnected 
user may recoveri but program terminal control will no 
longer be active!* 

j The macro provided for DTC is defined below: 

DISTC stiaddmlNT 

St = ON activates program terminal control 
» OFF deactivates program terminal control 
dddr-= 'Coptionali valid only if ST = ON! specifies the 

interrupt address when terminal control is attempted* 

INT « if specifiedi indicates to change the program address 
I to addr +20 octal when terminal control is attempted. 

= if not specified and addr is specified-! indicates to 
set the contents of address addr to one when terminal 
control is attempted * 
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APPENDIX C 
TRANSLATION TABLES 

The following information is necessary to be able to use binary mode 
input and output to terminals* 

All ASCII hexadecimal codes are listed as seven bit codes* The 
eighth bit is a parity bit for most ASCII terminals and will be 
a one or zero depending on the parity of the terminal* 

All Ixx correspondence octal codes are actually xx codesi but are 
only sent when the terminal is in upper case* The communications 
driver sets the proper case when translating characters* 

All correspondence codes are listed as six bit codes* A seventh and 
eighth are actually sent by the driver. The seventh bit is character 
parity -Cnormally odd> and the eighth bit is always set in order to 
I interface to the required (3SE in the multiplexer* 

EXAMPLE 

The command from a TTY: 

BINARY-. 20 -.am, 

will cause input to the primary file until 20 characters have been 
input or an "a" is input* 

EXA MPLE 

I Uhen a NOVAR S-m terminal is in lower case and **AAAa** is to be 
printed in binary mode by the user program-i the program must output 
the following codes: 
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1st 

cn 

lilord 

0007 

M33M 

M371 

M371 

^371 

Snd 

CPI 

lilord 

M337 

^371 

0000 

0000 

0000 
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ASCII Terminal Code Conversion Table 
Indexed by ASCII Code 


ASCII 

Internal 



Hexadecimal 

Octal 

Name 

Character Description 

00 

7655 

NUL 

FIRST CHARACTER OF A 3PE70? 

01 

7646 

SOH 

START OF HEADING 

02 

7660 

STX 

START OF TEXT 

03 

7636 

ETX 

END OF TEXT 

04 

7653 

EOT 

END OF TRANSMISSION 

05 

7410 

ENQ 

ENQUIRY 

06 

766 4 

ACK 

ACKNOWLEDGE 

07 

7634 

BEL 

BELL 

08 

7651 

BS 

BACKSPACE 

09 

7652 

IIT 

HORIZONTAL TAB 

OA 

67 

LF 

LINE FEED 

OB 

7645 

vt' 

VERTICAL TAB 

OC 

7656 

FF 

FOR^^ FEED 

CD 

Lb 

CR 

CARRIAGE RETURN 

OE 

7657 

SO 

SHIFT OUT 

OF 

7650 

SI 

SHIFT IN 

10 

7633 

DLE 

DATA LINK ESCAPE 

11 

7405 

DCl 

DEVICE CONTROL 1 (X-ON) 

12 

7635 

DC2 

DEVICE CONTROL 2 

13 

7406 

DC 3 

DEVICE CONTROL 3 (X-OFF) 

14 

7637 

DC4 

DEVICE CONTROL 4 (STOP) 

15 

7640 

NAK 

NEGATIVE ACKNOWLEDGE 

16 

7641 

SYN 

SYNCHRONOUS IDLE 

17 

7642 

ETB 

END OF TRANSMISSION BLOCK 

18 

7643 

CAN 

CANCEL 

19 

7644 

EM 

END OF MEDIUM 

lA 

7663 

SUB 

SUBSTITUTE 

IB 

7677 

ESC 

ESCAPE 

1C 

7672 

FS 

FILE SEPARATOR 

ID 

7654 

GS 

GROUP SEPARATOR 

IE 

7673 

RS 

RECORD SEPARATOR 

IF 

7675 

US 

UNIT SEPARATOR 

20 

55 


SPACE 

21 

7647 

EX 

EXCLAMATION POINT 

22 

60 

QU 

QUOTATION MARKS 

2 3 

71 

NM 

NUMBER SIGN 

24 

53 

$ 

DOLLAR SIGN 

25 

7402 

PC 

PERCENT 

26 

65 

AM 

AMPERSAND 

27 

64 

AP 

APOSTROPHE 

28 

. 51 

( 

OPENING PARENTHESIS 

29 

52 

) 

CLOSING PARENTHESIS 

2A 

47 

* 

ASTERISK 

23 

45 

+ 

PLUS 


AA 3777 





2C 

56 

f 

COMMA 

2D 

46 


HYPHEN (MINUS) 

2E 

57 

0 

PERIOD 

2F 

50 

/ 

SLANT 

30 

33 

0 


31 

34 

1 


32 

35 

2 


33 

36 

3 


34 

37 

4 


35 

40 

5 


36 

41 

6 


37 

42 

7 


38 

43 

8 


39 

44 

9 


3A 

63 

CL 

COLON 

3B 

77 

SC 

SEMICOLON 

3C 

72 

LT 

LESS THAN 

3D 

54 

=s 

EQUALS 

3E 

73 

GT 

GREATER THAN 

3F 

75 

QU 

QUESTION MARK 

40 

7401 

AT 

COM^^3RCIAL AT 

41 

01 

A 


42 

02 

B 


43 

03 

C 


44 

04 

D 


45 

05 

E 


46 

06 

F 


47 

07 

G 


48 

10 

TT 

4. A 


49 

11 

I 


4A 

12 

J 


4B 

13 

K 


4C 

14 

L 


4I> 

15 

i ‘ 


4j: 

16 

N 


4F 

17 

0 


50 

20 

P 


51 

21 

Q 


52 

22 

R 


53 

23 

S 


54 

24 

T 


55 

25 

U 


56 

26 

V 


57 

27 

w 



AA 3777 


CONTROL DATA CORPORATION 


DIVISION 


DOCUMENT CLASS_ 

PRODUCT NAME_ 

PRODUCT MODEL NO. 


ERS _ 

KRONOS S-1 

Eoaa*5.i 


_ PAGE NO. ly _ 

tVBER 7g,^ 3,7M 


ASCII Terminal Code Conversion Table 
Indexed by ASCII Code 


ASCII 

Hexadecimal 

Internal 

Octal 

Name 

Character Description 

58 

30 

X 


59 

31 

y 


5A 

32 

Z 


5B 

61 

OB 

OPENING BRACKET 

5C 

7666 

RS 

REVERSE SLANT 

5D 

62 

CB 

CLOSING BRACKET 

5E 

70 

CF 

CIRCUMFLEX 

5F 

7404 

UL 

UNDERLINE 

60 

740 3 

GV 

GRAVE ACCENT 

61 

7601 

A 

LC 

62 

7602 

B 

LC 

63 

7603 

C 

LC 

64 

7604 

D 

LC 

65 

7605 

E 

LC 

66 

7606 

F 

LC 

67 

7607 

G 

LC 

68 

7610 

H 

LC 

69 

7611 

I 

LC 

6A 

7612 

J 

LC 

6B 

7613 

K 

LC 

6C 

7614 

L 

LC 

6D 

7615 

M 

LC 

6E 

7616 

N 

LC 

6F 

7617 

0 

LC 

70 

7620 

P 

LC 

71 

7621 

Q 

LC 

72 

7622 

R 

LC 

73 

7623 

S 

LC 

74 

7624 

T 

LC 

75 

7625 

U 

LC 

76 

7626 

V 

LC 

77 

762 7 

W 

LC 

78 

7630 

X 

LC 

79 

7631 

Y 

LC 

7A 

7632 

Z 

LC 

7B 

7661 

LB 

OPENING BRACE 

7C 

7667 

VL 

VERTICAL LINE 

7D 

7662 

CB 

CLOSING BRACE 

7E 

7670 

TL 

TILDE (OVERLINE 

7F 

7410 

DEL 

DELETE 


AA 3T77 





CONTROL DATA CORPORATION 


DIVISION 


DOCUMENT CLASS___£SS_ 

PRODUCT NAME_ KRONOS 5 -1 

PRODUCT MODEL mo E0fl6»S-l 


_-__ PAfiP Mn IV C~5 _ 

...IP. 'l-BOflAK (.VULW /jw a,?'. 


ASCII Terminal Code Conversion Table Indexed 
by Internal display 


Internal 

ASCII 


Octal 

Hexadecimal 

Name 

00 


NULL 

01 

41 

A 

02 

42 

B 

03 

43 

C 

04 

44 

D 

05 

45 

E 

06 

46 

F 

07 

47 

G 

10 

48 

H 

11 

49 

I 

12 

4 A 

J 

13 

4B 

K 

14 

4C 

L 

15 

4D 

M 

16 

4E 

N 

17 

4F 

0 

20 

50 

P 

21 

51 

Q 

22 

52 

R 

2 3 

53 

S 

24 

54 

T 

25 

55 

U 

26 

56 

V 

27 

57 

w 

30 

58 

X 

31 

59 

Y 

32 

5A 

Z 

33 

30 

0 

34 

31 

1 

35 

32 

2 

36 

33 

3 

37 

34 

4 

40 

35 

5 

41 

36 

6 

42 

37 

7 

43 

38 

8 

44 

39 

9 

45 

2B 

+ 

46 

2D 


47 

2A 

★ 

50 

2F 

/ 

51 

28 

( 

52 

29 

) 

53 

24 

$ 


Character Description 


PLUS 

HYPHEN (MINUS) 

ASTERISK 

SLANT 

OPENING PARENTHESIS 
CLOSING PARENTHESIS 
DOLLAR SIGN 


AA sm 



CONTROL DATA CORPORATION 
. .—-DIVISION 

DOCUMENT CL ASS ___IS5 _- PAGE NO.-JDL-life_ 

PRODUCT N>«*1E_____ 

PRODUCT MOnPi NO E0fl6»5>l maphimf «;Pt^iFC taOOD CDC/CYBER ?5-.^ 3i7M 

ASCII Terminal Code Conversion Table Indexed 
by Internal Display 


Internal 

ASCII 



Octal 

Hexadecimal 

Name 

Character Description 

54 

3D 

= 

EQUALS 

55 

20 


SPACE 

56 

2C 

n 

COMMA 

57 

2E 

• 

PERIOD 

60 

22 

QM 

QUOTATION MARKS 

61 

5B 

OB 

OPENING BRACKET 

62 

5D 

CB 

CLOSING BRACKET 

63 

3A 

CL 

COLON 

64 

27 

AP 

APOSTROPHE 

65 

26 

AM 

AMPERSAND 

66 

OD 

CR 

CARRIAGE RETURN 

67 

OA 

LF 

LINE FEED 

70 

5E 

CF 

CIRCUMFLEX 

71 

23 

NM 

NUMBER SIGN 

72 

3C 

LT 

LESS THAN 

73 

3E 

GT 

GREATER THAN 

74 



ESCAPE e 

75 

3F 

QU 

QUESTION MARK 

76 



ESCAPE 1 

77 

3B 

SC 

£5EMICOI/)N 

7600 


NULL 


7601 

61 

A 

LC 

7602 

62 

B 

LC 

7603 

63 

C 

LC 

7604 

64 

D 

LC 

7605 

65 

E 

LC 

7606 

66 

F 

LC 

760 7 

67 

G 

LC 

7610 

68 

II 

LC 

7611 

69 

I 

LC 

7612 

6A 

J 

LC 

7613 

6B 

K 

LC 

7614 

6C 

L 

LC 

7615 

6D 

M 

LC 

7616 

6E 

N 

LC 

7617 

6F 

0 

LC 

7620 

70 

P 

LC 

7621 

71 

Q 

LC 

7622 

72 

R 

LC 

7623 

73 

S 

LC 

7624 

74 

T 

LC 

7625 

75 

U 

LC 

7626 

76 

V 

LC 

7627 

77 

W 

LC 


AA 3T77 


CONTROL DATA CORPORATION 


DIVISION 


DOCUMENT CLASS. 
PRODUCT NAME — 


PAGE NO. 



ASCII Terminal 

Code Conversion Table Indexed 


by 

Internal 

Display 

Internal 

ASCII 



Octal 

Hexadecimal 

Name 

Character Description 

76 30 

78 

X 

LC 

7631 

79 

Y 

LC 

76 32 

7A 

Z 

LC 

7633 

10 

DLE 

DATA LINK ESCAPE 

76 34 

07 

BEL 

BELL 

76 35 

12 

DC2 

DEVICE CONTROL 2 

76 36 

03 

ETX 

END OF TEXT 

76 37 

14 

DC 4 

DEVICE CONTROL 4 (STOP) 

7640 

15 

NAK 

NEGATIVE ACKNOWLEDGE 

7641 

16 

SYN 

SYNCHRONOUS IDLE 

7642 

17 

ETB 

END OF TRAIISMISSION BLOCK 

7643 

18 

CAN 

CANCEL 

7644 

19 

EM 

END OF MEDIUM 

7645 

OB 

VT 

VERTICAL TAB 

7646 

01 

SOH 

START OF HEADING 

7647 

21 

EX 

EXCLAMATION POINT 

7650 

OF 

SI 

SHIFT IN 

7651 

08 

BS 

BACKSPACE 

7652 

09 

HT 

HORIZONTAL TAB 

7653 

04 

EOT 

END OF TRAl<ISMISSION 

7654 

ID 

GS 

GROUP SEPARATOR 

7655 

00 

NUL 

NULL 

7656 

OC 

FF 

FORM FEED 

7657 

OE 

SO 

SHIFT OUT 

7660 

02 

STX 

START OF TEXT 

7661 

7B 

LB 

OPENING BRACE 

7662 

7D 

RB 

CLOSING BRACE 

766 3 

lA 

SUB 

SUBSTITUTE 

7664 

06 

ACK 

ACKNOtf LEDGE 

7665 

26 

AI^ 

AMPERSAND 

7666 

5C 

RS 

REVERSE SLANT 

7667 

7C 

VL 

VERTICAL LINE 

7670 

7E 

TL 

TILDE (OVEPLINE 

7671 

23 

NM 

NUMBER SIGN 

7672 

1C 

FS 

FILE SEPARATOR 

7673 

IE 

RS 

RECORD SEPARATOR 

7674 

7F 

DEL 

DELETE 

7675 

IP 

US 

UNIT SEPAPJ^.TOP 

7676 


NL 

NEW LINE 

7677 

IB 

ESC 

ESCAPE 

7400 


NULL 


7401 

40 

AT 

COMMERCIAi AT 

7402 

25 

PC 

PERCENT 

7403 

60 

GV 

GRAVE ACCENT 


AA 3T7T 



CONTROL DATA CORPORATION 

. . .DIVISION 

DOCUMENT CLASS__ PAGE NO._ 11 _ 

PRODUCT MAMP KRONOS g.l __ 

PRODUCT MODEL wn £066*5.1 _MACHINE cPRtP*; bOOO/CDC CYBER 7g-t73i?M 

ASCII Terminal Code Conversion Table Indexed 
by Internal ]>isplay 

Internal ASCII 

Octal Hexadecimal Name Character Description 

5F UL UNDERLINE 

11 DCl DEVICE control 1 (X-ON) 

13 DC3 DEVICE CONTROL 3 (X*OFF) 

05 ENQ ENQUIRY 


7404 

7405 

7406 

7407 


AA 3m 



CONTROL DATA CORPORATION 


DIVISION 


DOCUMENT CLASS_ 

PRODUCT NAME_ 

PRODUCT MODEL NO.. 


ERS 

KRONOS g 
E0fla*3.1 


PAGE NO. 


IV C-T 


MACHINE bOOD/CHC CYBER 75.7 3,7M 


Correspondence Terminal Code Conversion Table 
Indexed by Correspondence Code 


Correspondence Internal 
Octal Octal 


00 

55 

01 

62 

02 

7624 

03 

7612 

04 

37 

05 

7617 

06 

7614 

07 

50 

10 

40 

11 

64 

12 

7605 

13 

7620 

14 


15 


16 


17 


20 

35 

21 

57 

22 

7616 

23 

54 

24 

7632 

25 


26 


27 


30 

41 

31 

7611 

32 

7613 

33 

7621 

34 


35 

7651 

36 


37 


40 

34 

41 

7615 

42 

7630 

43 

7607 

44 

33 

45 

7623 

46 

7610 

47 

7631 

50 

42 

51 

7622 

52 

760 4 

53 

77 


Name Character Description 

SPACE 
1/2 
T LC 

J LC 

4 

0 LC 

L LC 

/ 

5 

AP APOSTROPHE 

E LC 

P LC 

NUIJi 
NUIjL 
NULL 
NULL 
2 

N LC 

Z LC 

NULL 
NULL 
NULL 

6 

I LC 

K LC 

Q LC 

UC UPPER CASE SHIFT 

BS BACKSPACE 

NULL 

LC LOWER CASE SHIFT 

1 

M LC 

X LC 

G LC 

0 

S LC 

H LC 

Y LC 

7 

R LC 

D LC 

SC SEMI-COLON 


AA 3777 


AM A 




CONTROL DATA CORPORATION 


DIVISION 


DOCUMENT CLASS ___X5S__ 

PRODUCT NAME_ KRONOS £•! 

PRODUCT MODEL no, £066*5-1 


_ PAOPNO IV C-3,D 

, -WUU Ul/HBLK 7^,7 3,7.. 


Correspondence Terminal Code Conversion Table 
Indexed by Correspondence Code 


Correspondence Internal 


Octal 

Oc 

54 


55 

TbTb 

56 

67 

57 

7652 

60 

36 

61 

7626 

62 

7625 

63 

7606 

64 

44 

65 

7627 

66 

7602 

67 

46 

70 

43 

71 

7601 

72 

760 3 

73 

56 

74 

55 

75 

7655 

76 


77 


100» 

55 

101 

61 

102 

24 

10 3 

12 

104 

53 

105 

17 

106 

14 

10 7 

75 

110 

7402 

111 

60 

112 

05 

113 

20 

114 


115 


116 


117 


120 

7401 

121 

7657 

122 

16 

12 3 

45 

124 

32 

125 


126 


12 7 



Name Character Description 
NUIJ. 

NL NEW LINE 
LF LINE FEED 
HT TAB 

3 

V LC 

U LC 

F LC 

9 

W LC 

B LC 

8 

A LC 

C LC 

EOT END OP TRANSMISSION 
NUL IDLE 
NULL 
CD 

SPACE 

1/4 

T 

J 

$ 

O 

L 

QU QUESTION 
PC PER-CENT 
DQ DIARESIS 

E 
P 

NULL 

NULL 

NULL 

NULL 

AT COMMERCIAL AT 

N 

+ 

Z 

NULL 

NULL 

NULL 


AA 3777 



CONTROL DATA CORPORATION 

DIVISION 

DOCUMENT CLASS 

ERS 

PACIP NO 

PRODUCT NAME 

KRONOS 5-1 


PRODUCT MODEL NO. 

Eoaa* 2 .i 

MACHINE SERIES tOOO COC/CYBER 72,73,7M 

Correspondence Terminal Code Conversion Table 


Indexed by 

Correspondence Code 

Correspondence 

Internal 


Octal 

Octal 

Name Character Description 

130 

7667 

CT CENT 

131 

11 

I 

132 

13 

K 

133 

21 

Q 

134 


UC UPPER CASE SHIFT 

135 

7651 

BS BACKSPACE 

136 


NULL 

137 


LC LOITER CASE SHIFT 

140 

7670 

+/- 

141 

15 

M 

142 

30 

X 

143 

07 

G 

144 

52 

) 

145 

23 

S 

146 

10 

H 

147 

31 

y 

150 

65 

AM AMPERSAND 

151 

22 

R 

152 

04 

D 

153 

63 

CL COLON 

154 


NULL 

155 

7b7t. 

NL NEW LINE 

156 

67 

LF LINE FEED 

157 

7652 

HT TAB 

160 

71 

NM NUMBER 

161 

26 

V 

162 

25 

U 

163 

06 

F 

164 

51 

( 

165 

27 

W 

166 

02 

B 

167 

7404 

UL UNDERLINE 

170 

47 

* 

171 

01 

A 

172 

03 

C 

173 

7656 

t 

174 

55 

EOT END OF TRANSMISSION 

175 

7655 

NUL IDLE 

176 


NULL 

177 


CD 

* NOTES All Ixx correspondence octal codes are upper case prints 

AA 3T77 






CONTROL DATA CORPORATION 


DiViSiON 


DOCUMENT ERS _ 

PRODUCT NAMP XRONOS S -l 

PRODUCT MODEL Kin £068*5.1 _ 


PAGE NO.—IV_C-15 Rev A 


MACHINE SERIES 


OTO'O' CK/CVyER Van?3i7M 


Correspondence Terminal Code Conversion Table 
Indexed by Internal Code 


Internal 

Octal 

Correspondence 

Octal 

Name 

Character Description 

00 

01 

171 

NULL 

A 


02 

166 

B 


0 3 

172 

C 


04 

152 

D 


05 

112 

E 


06 

163 

F 


07 

143 

G 


10 

146 

H 


11 

131 

I 


12 

103 

J 


13 

132 

K 


14 

106 

L 


15 

141 

M 


16 

122 

N 


17 

105 

0 


20 

113 

P 


21 

133 

Q 


22 

151 

R 


23 

145 

S 


24 

102 

T 


25 

162 

U 


26 

161 

V 


27 

165 

w 


30 

142 

X 


31 

147 

Y 


32 

124 

Z 


33 

44 

0 


34 

40 

1 


35 

20 

2 


36 

60 

3 


37 

04 

4 


40 

10 

5 


41 

30 

6 


42 

50 

7 


43 

70 

8 


44 

64 

9 


45 

123 

+ 


46 

67 



47 

170 

* 


50 

07 

/ 


51 

164 

( 


52 

144 

) 


53 

104 

$ 



AA S777 



CONTROL DATA CORPORATION 


DIVISION 


DOCUMENT CLASS_ 

PRODUCT NAME_ KRONOS 5-1 

PRODUCT MODEL NO._ED66*5 ,-.I 


_ PAGE NO_H 

MArHiMP«;pgtP< taOPfl C1 >C/cVb£k 75t7 3i7M 


Correspondence Terminal Code Conversion Table 
Indexed by Internal Code 


Internal 

Correspondence 



Octal 

Octal 

Name 

Character Description 

54 

23 

s 


55 

00 


SPACE 

56 

73 

9 


57 

21 

a 


60 

111 

DQ 

DIARESIS 

61 

101 


1/4 

62 

01 


1/2 

63 

153 

CL 

COLON 

64 

11 

AP 

APOSTROPHE 

65 

150 

AM 

AMPERSAND 

66 


CR 

CARRIAGE RETURN 

67 

SL 

LF 

LINE FEED 

70 


NULL 


71 

160 

NM 

NUMBER 

72 


NULL 


73 


NULL 


74 


NULL 


75 

107 

QU 

QUESTION 

76 


NULL 


77 

53 

SC 

SEMICOLON 

7600 


NULL 


7601 

71 

A 

LC 

7602 

66 

B 

LC 

760 3 

72 

C 

LC 

7604 

52 

D 

LC 

7605 

12 

E 

LC 

7606 

63 

F 

LC 

7607 

43 

G 

LC 

7610 

46 

H 

LC 

7611 

31 

I 

LC 

7612 

03 

J 

LC 

7613 

32 

K 

LC 

7614 

06 

L 

LC 

7615 

41 

M 

LC 

7616 

22 

N 

LC 

7617 

05 

0 

LC 

7620 

13 

P 

LC 

7621 

33 

Q 

LC 

7622 

51 

R 

LC 

7623 

45 

S 

LC 

7624 

02 

T 

LC 

7625 

62 

U 

LC 

7626 

61 

V 

LC 

7627 

65 

W 

LC 


AA 3777 



CONTROL DATA CORPORATION 


DIVISION 


DOCUMENT n A« ERS __ PAGE 

PRODUCT NAME_ KRONOS 2-1 _, . 

PRODUCT MODEL Mft E066»5 » l _MACHINE ■=;PaiF«; ^>000 CDC/CYBER 7Bi7 3i7M 

Correspondence Terminal Code Conversion Table 
Indexed by Internal Code 


Internal Correspondence 


Octal 

Octal 

7630 

42 

7631 

47 

7632 

24 

7633 


7634 


7635 


7636 


7637 


7640 


7641 


7642 


7643 


7644 


7645 


7646 


7647 


7650 


7651 

35 

7652 

57 

765 3 


7654 


7655 

75 

7656 

173 

7657 

121 

7660 


7661 


7662 


7663 


7664 


7665 


7666 


7667 

130 

7670 

140 

7671 


7672 


7673 


7674 


7675 


7676 

55 

7677 


7400 


7401 

20 

7402 

10 

7403 



Name Character Description 

X LC 

y LC 

Z LC 

NULL 

NULL 

NULL 

NULL 

NULL 

NULL 

NULL 

NULL 

NULL 

NULL 

NULL 

NUT.L 

NULL 

NULL 

BS BACKSPACE 
HT TAB 
NULL 
NULL 

NUL IDLE 


• 

NULL 

NULL 

NULL 

NULL 

NULL 

NULL 

NULL 

CT CENT 
+/“ 

NULL 

NULL 

NULL 

NULL 

NULL 

NL NEW LINE (CR/LP) 

NULL 

NULL 

AT COMJffiRCIAL AT 
PC PER-CENT 
NULL 


AA 3?77 



CONTROL DATA CORPORATION 


DIVISION 


DOCUMENT rt A«;«; ERS _ 

PRODUCT NAME_ ICRONOS S-l 

PRODUCT MODEL Mft £065*5-1 _ 


PAGE Mn IV C-15 Rev A 


MACHINE SERIES 


b'fitlQ CdC/CVBER 75,73.7M 


Correspondence Terminal Code Conversion Table 
Indexed by Internal Cdde 


Internal 

Correspondence 


Octal 

Octal 

Name 

7404 

67 

UL 

7405 


NULL 

7406 


NULL 

740 7 


NULL 


Character Description 

UNDERLINE 



CONTROL DATA CORPORATION 


DIVISION 


DOCUMENT CLASS_ 

PRODUCT NAME_ 

PRODUCT MODEL NO.. 


ERS _ 

KRONOs a. 


PAGE NO- 


MACHINE SERIES. 


Correspondence APL Terminal Conversion Code Table 
Indexed by Correspondence APL Code 


Correspondence 

Internal 


Octal 

Octal 

Name 

00 

55 


01 

7661 

IS 

02 

24 

T 

03 

12 

J 

04 

37 

4 

05 

17 

0 

06 

14 

L 

07 

50 

/ 

10 

40 

5 

11 

62 

CB 

12 

05 

E 

13 

20 

P 

14 


NULL 

15 


NULL 

16 


NULL 

17 


NULL 

20 

35 

2 

21 

57 

• 

22 

16 

N 

23 

65 

ML 

24 

32 

Z 

25 


NULL 

26 


NULL 

27 


NULL 

30 

41 

6 

31 

11 

I 

32 

13 

K 

33 

21 

Q 

34 


UC 

35 

7651 

BS 

36 


NULL 

37 


LC 

40 

34 

1 

41 

15 

M 

42 

30 

X 

43 

07 

G 

44 

33 

0 

45 

23 

S 

46 

10 

H 

47 

31 

y 

50 

42 

7 

51 

22 

R 

52 

04 

D 

53 

61 

OB 


Character Description 
SPACE 

SPECIFICATION ARROW 


CLOSE BRACKET 


MULTIPLICATIC»I 


UPPER CASE SHIFT 
BACKSPACE 

LOWER CASE SHIFT 


OPEN BRACKET 


AA 5777 


mt * 



CONTROL DATA CORPORATION 


DOCUMENT CLASS. 
PRODUCT NAME 


ERS 


KRONOS 5-1 


— DIVISION 
PAGE NO.—JLLSlilL 


Durx MOnPL Nn_ 


MArwiNP'JPRIPC bOOD COC/CYBER 72i7 

Correspondence APL 

Terminal Conversion Code Table 


Indexed by 

Correspondence APL Code 

■'respondence 

Internal 


Octal 

Octal 

Name Character Description 

54 


NULL 

55 

7t7b 

NL NEW LINE 

56 

67 

LF LINE FEED 

57 

7652 

HT TAB 

60 

36 

3 

61 

26 

V 

62 

25 

U 

6 3 

06 

F 

64 

44 

9 

65 

27 

W 

66 

02 

B 

67 

45 

+ 

70 

43 

8 

71 

01 

A 

72 

03 

C 

73 

56 

r 

74 

55 

EOT END OF TRANSMISSION 

75 

7655 

NUL IDLE 

76 


NULL 

77 


CD 

100 

55 

SPACE 

101 

7662 

GO BPiLNCII ARROW 

102 

7670 

TL TILDE 

10 3 

7612 

NL NULL OPERATOR 

104 

7613 

LE LESS THAN OR EQUAL 

105 

7617 

Cl CIRCLE 

106 

7614 

QD QUAD 

107 

7666 

BN REVERSE SLANT 

110 

54 

= 

111 

52 

) 

112 

7605 

EP EPSILON 

113 

47 

* 

114 


NULL 

115 


NULL 

116 


NULL 

117 


NULL 

120 

70 

NG NEGATION 

121 

63 

CL COLON 

122 

7616 

RP REPRESENTATION 

123 

7402 

DV DIVIDE 

124 

7632 


125 


NULL 

126 


NULL 

12 7 


NULL 


AA 5777 



CONTROL DATA CORPORATION 

. . . ..DIVISION 

DOCUMENT CLASS_ PAr.P MO IV C-lB 

PRODUCT NAME_ KRONOS g»l _ . 

PRODUCT MODEL NO E06fl»5.1 _MACHINE cpbif*; fc»00P CDC/CY&Eft '^5-i7 3->7M 

Correspondence APL Terminal Conversion Code Table 
Indexed by Correspondence APL Code 


Correspondence Internal 


Octal 

Octal 

Name 

Character Description 

130 

7620 

GE 

GREATER THAN OR EQUAL 

131 

7611 

10 

lOI’A 

132 

64 

QT 

QUOTE 

133 

75 

QU 

QUESTION 

134 


UC 

UPPER CASE SHIFT 

135 

7651 

BS 

BACKSPACE 

136 


NULL 


137 


LC 

LOWER CASE SHIFT 

140 

60 

DQ 

DIARESIS 

141 

7667 

MD 

MODULUS 

142 

7630 

ID 

IMBED 

143 

7607 

DL 

DEL 

144 

7401 

AN 

AND 

145 

7623 

MX 

MAXIMUM 

146 

7610 

DT 

DELTA 

147 

7631 

TA 

TAKE 

150 

73 

GT 

GREATER THAN 

151 

7622 

RO 

RHO 

152 

7604 


MINIMUM 

15 3 

51 

( 


154 


NULL 


155 

7t7t 

NL 

NEW LINE 

156 

67 

LF 

LINE FEED 

157 

7652 

HT 

TAB 

160 

72 

LT 

LESS THAN 

161 

7626 

UN 

UNION 

162 

7625 

DR 

DROP 

16 3 

7606 

UL 

UNDER LINE 

164 

7403 

OR 

OR 

165 

7627 

OM 

OMEGA 

166 

7602 

EV 

EVALUATION 

167 

46 

- 


170 

71 

NE 

NOT EQUAL 

171 

53 

AL 

ALPHA 

172 

760 3 

IX 

INTERSECTION 

173 

77 

SC 

SEMICOLON 

174 

55 

EOT 

END OF TRANSf-lISSION 

175 

7655 

IL 

IDLE 

176 


NULL 


177 


CD 



AA 5777 



DOCUMENT CLASS_ 

PRODUCT NAME_ 

PRODUCT MODEL NO. 


CONTROL DATA CORPORATION 


DIVISION 


ERS 

’WmWTT 

Eoas*2.i 


PAGE NO.. 


IV C-IR Rev A 


MACHINE bOOO CDC/CYBER 7g..7 3.7>l 


Correspondence APL Terminal Conversion Code Table 
Indexed by Internal Code 


Internal 

Octal 

Correspondence 

Octal 

Name 

00 

01 

71 

NULL 

A 

02 

66 

B 

03 

72 

C 

04 

52 

D 

05 

12 

E 

06 

63 

F 

07 

43 

G 

10 

46 

11 

11 

31 

I 

12 

03 

J 

13 

32 

K 

14 

06 

L 

15 

41 

M 

16 

22 

N 

17 

05 

0 

20 

13 

P 

21 

33 

Q 

22 

51 

R 

2 3 

45 

S 

24 

02 

T 

25 

62 

U 

26 

61 

V 

27 

65 

W 

30 

42 

X 

31 

47 

y 

32 

24 

z 

33 

44 

0 

34 

40 

1 

35 

20 

2 

36 

60 

3 

37 

04 

4 

40 

10 

5 

41 

30 

6 

42 

50 

7 

43 

70 

8 

44 

64 

9 

45 

67 

+ 

46 

167 

- 

47 

113 

* 

50 

07 

/ 

51 

153 

( 

52 

111 

) 

53 

171 

AL 


Character Pescription 


ALPHA 


AA 3777 



CONTROL DATA CORPORATION 


DIVISION 


DOCUMENT CLASS__-_ PAGE NO__ 

PRODUCT NAMF KRONOS g . 1. .. .. ^ 

PRODUCT MOnPi Kin. E 066 *g -1 MArumc cfricc taOOO CDC/CVb£R 7 M 

Correspondence APL Terminal Conversion Code Table 
Indexed by Internal Code 


Internal 

Correspondence 


Octal 

Octal 

Name 

54 

110 

ss 

55 

00 


56 

73 

/ 

57 

21 

a 

60 

140 

DQ 

61 

53 

OB 

62 

11 

CB 

63 

121 

CL 

64 

132 

AT 

65 

23 

ML 

66 


CR 

67 

51 

LF 

70 

120 

NG 

71 

170 

NE 

72 

160 

LT 

73 

150 

GT 

74 


NULL 

75 

133 

QU 

76 


NULL 

77 

173 

SC 

7600 


NULL 

7601 

171 

AL 

7602 

166 

EV 

7603 

172 

IX 

7604 

152 

MN 

7605 

112 

EP 

7606 

163 

UL 

7607 

143 

DL 

7610 

146 

DT 

7611 

131 

10 

7612 

103 

NL 

7613 

104 

LE 

7614 

106 

QD 

7615 

141 

MD 

7616 

l22 

RP 

7617 

105 

Cl 

7620 

130 

GE 

7621 

133 

QU 

7622 

151 

RO 

762 3 

145 

MX 

7624 

102 

TL 

7625 

162 

DR 

7626 

161 

UN 

762 7 

165 

OM 


Character Description 
SPACE 


DI ARESIS 
OPEN BRACKET 
CLOSE BRACKET 
COLON 
(3U0TE 

MUI^TIPLY 
CARRIAGE RETURN 
LINE FEED 
NEGATION 
NOT EQUAL 
LESS THAN 
GREATER THAN 

QUESTION 

SEMICOLON 

ALPHA 

EVALUATION 

INTERSECTION 

MINIMUM 

EPSILON 

UNDERLINE 

DEL 

DELTA 

IOTA 

NULL OPERATOR 
LESS THAN OR EQUAL 
QUAD 
MODULUS 

REPRESENTATION 

CIRCLE 

GREATER THAN OR EQUAL 

QUESTION 

RHO 

MAXIMUM 

TILDE 

DROP 

LiNION 

OMEGA 


AA 3777 



CONTROL DATA CORPORATION 

_' -DIVISION 

DOCUMENT CLASS-—-—_ PAr.P mo IV C-51 

PRODUCT NAME_ KRONOS 5-1 _ 

PRODUCT MODEL Kin EDaa*a «l_MACHINE bPOO CPC/CYBER 7gi73-»7M 

Correspondence APL Terminal Conversion Code Table 
Indexed by Internal Code 


Internal Correspondence 
Octal Octal 


7630 

142 

7631 

147 

76 32 

124 

7633 


7634 


7635 


76 36 


7637 


7640 


7641 


7642 


7643 


764 4 


7645 


76 46 


7647 


7650 


7651 

35 

7652 

157 

765 3 


7654 


7655 

75 

7656 


7657 


7660 


7661 

01 

7662 

IDl 

7663 


7664 


7665 


7666 

107 

766 7 

141 

7670 

102 

7671 


7672 


7673 


7674 


7675 


7676 

55 

7677 


7400 


7401 

144 

7402 

123 

7403 

164 


Name Character Description 
ID IMBED 
TA TAKE 
SB SUBSET 
NULL 
NULL 
NUI.L 
NULL 
NULL 

Null 

NULL 

NULL 

NULL 

NULL 

NULL 

NULL 

NULL 

NULL 

BS BACKSPACE 
HT TAB 
NULL 
NULL 

NUL IDLE 
NULL 
NULL 
NULL 

IS SPECIFICATION ARROW 

GO BRANCH ARROW 

NULL 

NULL 

NULL 

BN REVERSE SLANT 

MD MODULUS 

TL TILDE 

NUr.L 

NULL 

NULL 

NULL 

NULL 

NL NEIV LINE 

NULL 

NULL 

AN AND 
DV DIVIDE 
OR OR 


AA 3TT7 



CONTROL DATA CORPORATION 

---DIVISION 

DOCUMENT CLASS_1^5_ PAr.P Mrt IV C-ge 

PRODUCT NAME_ KRONOS 5.1 __, , _ , , 

PRODUCTMOnpi Mr> EDa6»5-l . MArHiM(= CPC/CYBER 7g^ 3i7M 

Correspondence APL Terminal Conversion Code Table 
Indexed by Internal Code 


Internal 

Correspondence 



Octal 

Octal 

Name 

Character Description 

7404 


NULL 


7405 


NULL 


7406 


NULL 


7407 


NULL 



E 

AA 3777 



CONTROL DATA CORPORATION 

___DIVISION 

DOCUMgNT rt Ag; ERS _^__ PAnPMn IV C-S3 Rev A 

PRODUCT NAME_ KRONOS 5.1 __ 

PRODUCT MODEL wn EDfia*g»l _MACHINE <;pgiP^ ^000 CPC/CYBER 75i7 3-»7M 

flemorex APL Code Conversion Table Indexed 
by Hemorex APL Code 


Hemorex^ 

Internal 



Hexadecimal 

Octal 

Name 

Character Description 

00 

7655 

NUL 

FIRST CHARACTER OF A BREA 

01 

7646 

SOH 

START OF HEADING 

02 

7660 

STX 

START OF TEXT 

03 

7636 

ETX 

END OF TEXT 

04 

765 3 

EOT 

END OF TRANSMISSION 

05 

7410 

ENQ 

ENQUIRY 

06 

7664 

ACK 

ACKNOWLEDGE 

07 

7634 

BEL 

BELL 

08 

7651 

BS 

BACKSPACE 

09 

7652 

HT 

HORIZONTAL TAB 

OA 

67 

LF 

LINE FEED 

OB 

7645 

VT 

VERTICAL TAB 

OC 

7656 

FF 

FORM FEED 

OD 

bb 

CR 

CARRIAGE RETURN 

OE 

7657 

SO 

SHIFT OUT 

OF 

7650 

SI 

SHIFT IN 

10 

7633 

DLE 

DATA LINK ESCAPE 

11 

7405 

DCl 

DEVICE CONTROL 1 (X-ON) 

12 

7635 

DC2 

DEVICE CONTROL 2 

13 

7406 

DC 3 

DEVICE CONTROL 3 (X-OFF) 

14 

76 37 

DC 4 

DEVICE CONTROL 4 (STOP) 

15 

7640 

NAK 

NEGATIVE ACKl^OWLEDGE 

16 

7641 

SYN 

SYNCHRONOUS IDLE 

17 

7642 

ETB 

END OF TRANSMISSION BLOCK 

18 

7643 

CAN 

CANCEL 

19 

76 44 

EM 

END OF MEDIUM 

lA 

7663 

SUB 

SUBSTITUTE 

IB 

7677 

ESC 

ESCAPE 

1C 

7672 

FS 

PILE SEPARATOR 

ID 

7654 

GS 

GROUP SEPARATOR 

IE 

7673 

RS 

RECORD SEPARATOR 

IF 

7675 

US 

UNIT SEPARATOR 

20 

55 


SPACE 

21 

60 

DQ 

DIARESIS 

22 

70 

NG 

NEGATION 

23 

72 

LT 

LESS THAN 

24 

7620 

LE 

LESS THAN OR EQUAL 

25 

54 

s 

EQUAL 

26 

7621 

GE 

GREATER THAN OR EQUAL 

27 

73 

GT 

GREATER THAN 

28 

7624 

NE 

NOT EQUAL 

29 

7647 

OR 

OR 

2A 

52 

) 

CLOSING PARENTHESIS 

2B 

51 

( 

OPENING PARENTHESIS 
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CONTROL DATA CORPORATION 


DIVISION 


DOCUMENT rLAg; ETRS _^_ PAGE NO_ VL __ 

PRODUCT NAME _ ^^!^ KRONOS E-1 _ ' 

PRODUCT MODEL mo E0afl»a»l _MACHINE «;prip<; bPOO CDC/CYBER 78i7 3<i7M 

Memorex APL Code Conversion Table Indexed 
by Memorex APL Code 


Memorex 

Hexadecimal 

Internal 

Octal 

Name 

Character Description 

2C 

56 

f 

COMMA 

2D 

45 

•f 

PLUS 

2E 

57 

• 

PERIOD 

2F 

50 

/ 

SLANT 

30 

33 

0 


31 

34 

1 


32 

35 

2 


33 

36 

3 


34 

37 

4 


35 

40 

5 


36 

41 

6 


37 

42 

7 


38 

43 

8 


39 

44 

9 


3A 

62 

CB 

CLOSE BRACKET 

3B 

61 

OB 

OPEN BRACKET 

3C 

77 

SC 

SEMICOLON 

3D 

46 

- 

MINUS 

3E 

63 

CL 

COLON 

3F 

7666 

BN 

REVERSE SLANT 

40 

7613 

IS 

SPECIFICATION ARROW 

41 

7601 

AL 

ALPHA 

42 

7602 

EV 

EVALUATION 

43 

7603 

IX 

INTERSECTION 

44 

7604 

MN 

MINIMUM 

45 

7605 

EP 

EPSILON 

46 

7404 

UL 

UNDERLINE 

47 

7607 

DL 

DEL 

48 

7610 

DT 

DELTA 

49 

7611 

10 

IOTA 

4A 

7612 

NL 

NULL OPERATOR 

4B 

64 

QT 

QUOTE 

4C 

7614 

QD 

QUAD 

4D 

7667 

MD 

MODULUS 

4E 

7616 

RP 

REPRESENTATION 

4F 

7617 

Cl 

CIRCLE 

50 

47 

* 

ASTERISK 

51 

75 

QU 

QUESTION 

52 

7622 

RO 

RHO 

53 

7623 

MX 

MAXIMUM 

54 

7670 

TL 

TILDE 

55 

7625 

DR 

DROP 

56 

7626 

UN 

UNION 

57 

7627 

OM 

OMEGA 
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CONTROL DATA CORPORATION 


DIVISION 


DOCUMENT CLASS_ 

PRODUCT NAME_ 

PRODUCT MODEL NO. 


ERS 

KKONO'S ■2Tr 


Eoaa»5.^ 


___ PAr.F Mn IV c-as 

MACHINE faOOO CDC CYBER ?5t73-i7M 


Memorex APL Code Conversion Table Indexed 
by Memorex APL Code 


Memorex 

Hexadecimal 

Internal 

Octal 

Name 

Character Description 

58 

7630 

ID 

IPffiED 

59 

7631 

TA 

TAKE 

5A 

7632 

SB 

SUBSET 

5B 

65 

ML 

MUI.TIPLI CATION 

5C 

7615 

GO 

BRANCH ARROW 

5D 

7403 


NOT EQUIVALENCE 

5E 

71 

CT 

CENT 

5F 

7606 

AN 

AND 

60 

60 

LB 

OPENING BRACE 

61 

01 

A 


62 

02 

B 


63 

03 

C 


64 

04 

D 


65 

05 

E 


66 

06 

F 


67 

07 

G 


68 

10 

H 


69 

11 

I 


6A 

12 

J 


6B 

13 

K 


6C 

14 

L 


6D 

15 

M 


6E 

16 

N 


6F 

17 

0 


70 

20 

P 


71 

21 

Q 


72 

22 

R 


73 

23 

S 


74 

24 

T 


75 

25 

U 


76 

26 

V 


77 

27 

W 


78 

30 

X 


79 

31 

Y 


7A 

32 

Z 


7B 

7402 

DV 

DIVIDE 

7C 

7662 

RB 

CLOSING BRACE 

7D 

7401 


EQUIVALENCE 

7E 

53 

$ 

DOLLAR SIGN 

7F 

7410 

DEL 

DELETE 


AA 8777 
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CONTROL DATA CORPORATION 


DIVISION 


DOCUMENT CLASS_ 

PRODUCT NAME_ 

PRODUCT MODEL NO. 


ERS 

wmm: 

EoSa*n 


PAGE NO. 


IV 


c-ab 




Memorex APL Code Conversion Table Indexed 
by Internal Display Code 


Internal Nemorex 


Octal 

Hexadecimal 

Name 

00 


NULL 

01 

61 

A 

02 

62 

B 

03 

63 

C 

04 

64 

D 

05 

65 

E 

06 

66 

F 

07 

67 

G 

10 

68 

H 

11 

69 

I 

12 

6A 

J 

13 

6B 

K 

14 

6C 

L 

15 

6D 

M 

16 

6E 

N 

17 

6F 

0 

20 

70 

P 

21 

71 

Q 

22 

72 

R 

23 

73 

S 

24 

74 

T 

25 

75 

U 

26 

76 

V 

27 

77 

W 

30 

78 

X 

31 

79 

Y 

32 

7A 

Z 

33 

30 

0 

34 

31 

1 

35 

32 

2 

36 

33 

3 

37 

34 

4 

40 

35 

5 

41 

36 

6 

42 

37 

7 

43 

38 

8 

44 

39 

9 

45 

2D 

+ 

46 

3D 

— 

47 

50 

* 

50 

2F 

/ 

51 

2B 

( 

52 

2A 

) 

53 

7E 

$ 


Character Description 


PLUS 

HYPHEN (MINUS) 

ASTERISK 

SLANT 

OPENING PARENTHESIS 
CLOSING PARENTHESIS 
DOLLAR SIGN 
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CONTROL DATA CORPORATION 

____DIVISION 

DOCUMENT CLASS_—__ pacf Mn IV C-57 Rev A 

PRODUCT NAME_ KRONOS g-l ____ 

PRODUCT MODEL mo £056*5.1 __MACHINE cfripc faPDO CDC CYBER 7g-»7 3-17M 

Memorex APL Code Conversion Table Indexed 
by Internal Display Code 


Internal 

tiemorex 



Octal 

Hexadecimal 

Name 

Character Description 

54 

25 

ss 

EQUALS 

55 

20 


SPACE 

56 

2C 


COMMA 

57 

2E 

• 

PERIOD 

60 

21 

DQ 

DIARESIS 

61 

3B 

OB 

OPENING BRACKET 

62 

3A 

CB 

CLOSING BRACKET 

63 

3E 

CL 

COLON 

64 

4B 

QT 

QUOTE 

65 

5C 

ML 

MULTIPLY 

66 

OD 

CR 

CARRIAGE RETURN 

67 

OA 

LF 

LINE PEED 

70 

22 

NG 

NEGATION 

71 

5E 

CT 

CENT 

72 

23 

LT 

LESS THAN 

73 

27 

GT 

GREATER THAN 

74 


NULL 


75 

51 

QU 

QUESTION MARK 

76 


NULL 


77 

3C 

SC 

SEMICOLON 

7600 


NULL 


7601 

41 

AL 

ALPHA 

7602 

42 

EV 

EVALUATION 

7603 

43 

IX 

INTERSECTION 

7604 

44 

MN 

MINIMUM 

7605 

45 

EP 

EPSILON 

7606 

5F 

AN 

AND 

7607 

47 

DL 

DEL 

7610 

48 

DT 

DELTA 

7611 

49 

10 

IOTA 

7612 

4A 

NL 

NULL OPERATOR 

7613 

40 

IS 

SPECIFICATION ARROW 

7614 

4C 

QD 

QUAD 

7615 

5C 

GO 

BRANCH ARROW 

7616 

4E 

RP 

REPRESENTATION 

7617 

4F 

Cl 

CIRCLE 

7620 

24 

LE 

LESS THAN OR EQUAL 

7621 

26 

GE 

GREATER THAN OR EQUAL 

7622 

52 

RO 

RHO 

762 3 

53 

MX 

MAXIMUM 

7624 

28 

NE 

NOT EQUAL 

7625 

55 

DR 

DROP 

7626 

56 

UN 

UNION 

7627 

57 

OK 

OMEGA 


AA 3777 



CONTROL DATA CORPORATION 


DIVISION 


DOCUMENT CLASS , SE'-t,- PAGE NO__ 

PRODUCT NAMP t^i^ONOS 5.1 __ 

PRODUCT MODEL mo E06a»5 ._l _MArHiMP ^prip«; bOOO CPC CYBER 7g-i73-i7M 

flemorsx APL Code Conversion Table Indexed 
by Internal Display Code 

Internal flemorex 


Octal 

Hexadecimal 

Name 

Character Description 

7630 

58 

ID 

IMBED 

7631 

59 

TA 

TAKE 

76 3?. 

5A 

SB 

SUBSET 

7633 

10 

DLE 

DATA LINK ESCAPE 

76 34 

07 

BEL 

BELL 

7635 

12 

DC2 

DEVICE CONTROL 2 

7636 

03 

ETX 

END OF TEXT 

7637 

14 

DC4 

DEVICE CONTROL 4 (STOP) 

7640 

15 

NAK 

NEGATIVE ACKNOWLEDGE 

7541 

16 

SYN 

SYNCHRONOUS IDLE 

7642 

17 

ETB 

END OF TRANSMISSION BLOCK 

7643 

18 

CAN 

CANCEL 

7644 

19 

EM 

END OF MEDIUM 

7645 

OB 

VT 

VERTICAL TAB 

7646 

01 

SOH 

START OF HEADING 

7647 

29 

OR 

OR 

7650 

OF 

SI 

SHIFT IN 

7651 

08 

BS 

BACKSPACE 

7652 

09 

HT 

HORIZONTAL TAB 

7653 

04 

EOT 

END OF TRANSMISSION 

7654 

ID 

GS 

GROUP SEPARATOR 

7655 

00 

NUL 

NULL 

7656 

OC 

FF 

FORM FEED 

7657 

OF 

SO 

SHIFT OUT 

7660 

02 

STX 

START OF TEXT 

7661 

60 

LB 

OPENING BRACE 

7662 

7C 

RB 

CLOSING BRACE 

7663 

lA 

SUB 

SUBSTITUTE 

7664 

06 

ACK 

ACKNOWLEDGE 

7665 

7666 

3F 

BN 

REVERSE SLANT 

7667 

4D 

MD 

MODULUS 

7670 

54 

TL 

TILDE 

7671 

7672 

1C 

PS 

PILE SEPARATOR 

7673 

IE 

RS 

RECORD SEPARATOR 

7674 

7F 

DEL 

DELETE 

7675 

IF 

US 

UNIT■separator 

7676 


NL 

NEW LINE 

7677 

IB 

ESC 

ESCAPE 

7400 

.7401 

71) 

NULL 

EQU.TVALENCE 

7402 

7R 

DV 

DIVIDE 

7403 

5D 


NOT EQUIVALENCE 
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CONTROL DATA CORPORATION 
-^-DIVISION 


DOCUMENT CLASS_ 

PRODUCT NAME_ 

PRODUCT MODEL NO, 


ERS 

KRONOS E.'I 
E06a»B.l 


PAGE NO. 


IV C-B^ 


MACHINE CPRIPC faOOD CPC CYBER 7B-. 73-.?« 


Memorex APL Code Conversion Table Indexed 
by Internal Display Code 


Internal 

Octal 

Memorex 

Hexadecimal 

Name 

Character Description 

7404 

46 

UL 

UNDERLINE 

7405 

11 

DCl 

DEVICE CONTROL 1 (X-ON) 

7406 

13 

DCS 

DEVICE CONTROL 3 (X-OFF) 

7407 

05 

ENQ 

ENQUIRY 


AA 3777 



CONTROL DATA CORPORATION 


DIVISION 


DOCUMENT CLASS__PAGE NO._ )L _i_Sev_ 

PRODUCT NAME_ KRONOS g.l __ 

PRODUCT MODEL mo EOflfl^g.l _MACHINE <iPRiP<; CYBER 7ai73-.7M 


TABLE OF CONTENTS 


SECTION 



PAGE 

1.0 

SCOPE 



1 

2.0 

APPLICABLE 

DOCUMENTS 


2 

3.0 

DESCRIPTION 



3 


3.1 Special System Job Processing 


4 


3.1.1 

Fast Attach 


4 


3.1.2 

Timed/Event Rollout 


S 


3.2 Special System Jobs 


6 


3.2.1 

System File Supervisor 


6 


3.2.2 

PROFILO - Special System 

File 

12 



3.2.2.1 PROFILE 


13 



3.2.2.2 CHARGE 


34 



3.2.2.3 PROJECT 


3^ 


3.2.3 

VALIDUS - Special System 

File 

42 



3.2.3.1 MODVAL 


42 



3.2.3.2 PASSUOR Control 

Card 

S4 



3.2.3.3 LIMITS Control Card 

L2.1 


M.O DEFINITIONS t,3 

APPENDIX A — MANUAL Re'Fepences A-1 
APPENDIX B - ACCOUNTING Dayfile Messages B-1 
APPENDIX C — PROFILE List Option Examples C-1 
APPENDIX D — DSD and DIS Commands D-1 
APPENDIX E — Special Entry Points E-1 


AA 3777 


mimsmusA. 



CONTROL DATA CORPORATION 


DIVISION 


DOCUMENT CLASS____ PAGE NO .—1 _ 

PRODUCT NAME_ KRONOS g.l ___ 

PRODUCT MODEL NO_ EOaa^S.l _MACHINE bPDO/CDC CYBER 7a-i7 3-i7M 

1.0 SCOPE 

1.1 This specification provides the characteristics of the User 

Profile Control feature. This includes the system feature to 
control processing of special system jobs and also the individual 
modules being developed as special system jobs. These modules 
include PROFILEn CHARGE and PROJECT* which maintain and interrogate 
PROFILO. PROFILO contains information which can be used to 
control the resouces of a user. The other module is HODVALn 
which maintains VALIDUS. VALIOUS contains information used in 
validating a users use of the system. 


* PROJECT will be released only if time and resources allow. 
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5.0 APPLICABLE DOCUMENTS 

5.1 POD - KRONOS Version B-l 

KRONOS VB.D - Batch User’s Reference Manual 
KRONOS VB-O - Time-Sharing User's Manual 
KRONOS V5.Q - Operator's Guide 
KRONOS VB.O - Installation Handbook 
KRONOS V5.0 - Instant KRONOS 
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3.0 DESCRIPTION 

System capabilities described in this section deal with the 
problems that arise in validating user controls. System 
security must be maintained during validation while usersn who 
are normally prevented from accessing system resources such as 
those required for validation t are processed. The system 
insures that no user is allowed to access files containing 
system access only information. Jobs to interface these files 
{example - PROFILE! are run under special system control. 

These jobs can be interactive when necessary. The system 
provides total memory security for these Jobs. Restrictions 
from individual user validations do not prevent access to the 
user profile control features. The special system jobs per¬ 
forming these functions execute under their own controlsi and 
the user's validation controls are restored in the users 
control point upon completion of the task. 

This section also describes a set of system modules which 
maintain the special system files. These modules interface 
to the special system job feature to take advantage of the 
security and other capabilities it provides. 
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Processing of Special System Jobs 

Special system Jobs are validated by system LIBDECK entries 
and identified by special {SSJ=} entry points assembled within 
them. When the system recognizes such jobsi the user's validation 
parameters are stored within his field length at the address 
specified by the SSJ= entry point. -CThe special system Jobs are 
designed to allow expansion of the storage area to a full control 
point area of information! SOOB words!. Validation parameters 
are then entered in the control point area to allow the special 
system Job to access the system files and resources necessary 
to perform its functions. Upon Job completion or Job aborti 
the system replaces the user's original validation controls and 
insures that all files requiring security are returned. Normal 
system processing of the user resumes with no information from 
the special system Job's field length available to any user. 

The following features are provided to reduce system overhead 
in processing such Jobs. 

3.1.1 Fast Attach 

The catalog searching and the system sector reading and writing 
involved in accessing direct access files places a burden on 
the system when used heavily. To alleviate thisi the interlock 
of certain special permanent files is done through the File Name 
Table rather than mass storage. The interlocks are similar to 
those done for direct access files in their system sectors.* 

♦Refer to the PFn and Utilities Enhancements ERS Section 3.S. 


AA 3777 


mHfwmusA. 



CONTROL DATA CORPORATION 


DIVISION 


DOCUMENT CLASS__ PAGE NO._ )i. _- 

PRODUCT NAME _ KRONOS g.l __ 

PRODUCT MODEL NO_ EDaa»S« 1 _MACHINE <;prif«: taOOD/CPC CYBER 7 Bi73t7M 

System sector information will still be used to allow file 
recovery if central memory is destroyed. Programs will access 
these special files through *PFM* with the ATTACH macro. 

3.1.2 Timed/Event Rollout 

The timed/event rollout feature allows jobs to access system 
resources as they become available. Through use of the ROLLOUT 
macro 1 the user may request to be rolled out until an event 
occurs or for a fixed period of time. If the desired event 
does not occur within the specified time periodi the job will 
be scheduled to roll-in for further processing anyway. 

To determine when a specified event has occurredi a system 
event table is maintained in low core. System programs can 
make entries in this table to indicate occurrence of events. 

The job scheduler compares the requested event with the system 
events recorded in this table to determine if any matches have 
occurred. If a match occursn the job scheduler initiates roll- 
in. If no one is waiting for the system events they are 
cleared from the table. 

Specifying a timen with all event rollouts t insures that the 
job will rollin even if the event is lost or never occurs. 

Because the user may rollin for two different reasons t it is 
the users responsibility to verify whether the event desired 
actually occurred. 
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ROLLOUT - call format- 
ROLLOUT addr 

Entry - If addr is not specified! rollout job- If addr is 
present! rollout job for time/event described at RA+addr- 


addr 


/O 


2 T_ _ ^ 

/evd /rtp 



Uhere: 

rtp = rollout time period in Job scheduler delay intervals 
■CD ^ rtp ^ 7777B}. If rtp = 0 the job rolls out for a time 
determined by the system to insure that the job will roll 
in if the event he is waiting for is lost or never occurs. 


evd = event descriptor- 

If evd is non-zero! the event descriptor and rollout time 
period! rtp! are placed in the control point area -CUPCUl- 
When the job rolls out it will wait for the occurrence of 
the event in evd or the specified time period -Crtpl to 
elapse before becoming eligible for rollin- 

If evd =0! event is taken from control point area and only 
the rollout time period is taken from RA + addr. This 
option allows the user to rollout waiting for events that 
the system specifies. 
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If evd = 77D0 XXBt extended timed rollout is made. {Assume 
the job scheduler delay is 1 second}. Since the maximum 
time rtp can specify is approximately 1 hour and fi minutesi 
the extended time rollout allows the user to roll out for 
any length of time. This is a strict time rollout with 
no event dependency. Job rolls out for {77775i:XX + rtp>B 
seconds. 


Programming Note: 

It is possible for the central program to get the CPU before 
the rollout flag is detected by the system. In cases where 
it is necessary that the calling program know that the 
rollout has occurred-* he should interrogate the ^UPCU* word 
of the control point area. The lower thirty bits of xUPCU* 

= 0 indicate that the job has rolled out and either the 
event required has occurred or the time period has elapsed. 

EXAMPLES: 

1. Attempted attach results in file busy. Assume error 

processing is set. Upon restarting the job-i use of the 
rollout macro with evd = D will rollout for time speci¬ 
fied by *rtp* waiting for the event - file ready to be 
accessed. {DRP enters this event in the system event 
table when the file becomes not busy}. PFM stored the 
descriptor for this event in the control point area 
{UPCU} when it found the file busy but it did not set 
thfi rollout flag-i allowing the user to choose whether 


AA 3777 


pRimamusA. 



CONTROL DATA CORPORATION 

_DIVISION 

DOCUMENT CLASS__ PAGE Mn V Rev A | 

PRODUCT NAME_ KRONOS g.l _ 

•PRODUCT MODEL NO_ EDaa»5.1 _MACHINE SERIES bOQQ/CPC..CYBER 75i73-»7M 


to rollout immediately or to process some other function 
first. 
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S« Job Dependency* 

Suppose that before JOBl continues processing that he 
wants JOBS -Ca system origin type job> to execute a 
certain function* Assume JOBl uses the rollout macro 
with evd = 1300 and rtp = bOD* The rollout flag will 
be set for JOBl to rollout for bOO seconds or until 
event 1300 takes place* Before the bOO seconds has 
elapsedn suppose JOBS makes the macro call - EESET 1300 
entering the event 1300 in the system event table* JOBl 
will then be scheduled for rollin to resume processing* 

If bOO seconds elapse because event 1300 has not occurred 
•Cor the event was cleared from the table before JOBl 
rolled out>T JOBl will be scheduled for rollin* 

3»S Following are the specifications for the special system file 
maintenance modules being developed as special system jobs* 

3*S*1 SFS - Special System File Supervisor 

SFS provides macros and a function processor for a set of 
routines common to all of the system file processors* The 
routines perform basic table management-! data manipulation 
and I/O processing for the special system file processorsi 
which process tree structured files* SFS must be loaded as 
a OliOO overlay to one of the system file processors* 


^ See the KRONOS 5*1 Internal Maintenance Specification for detail on 
this macro* 
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SFS is designed to process tree-structured files of a given 
format* The functions are designed to process many 
levels of tree structure t howeveri table space is only 
allocated for a three-level tree structured file -CB 
directory levels + 1 data level!. 

The first word of each record on the file is the control 
word containing sufficient information to describe the data 
within the record. The second word is not used for most 
records -Clevel-Oi record word H contains file creation 
and update dates-* and a 5M bit field to be used by the 
processor program!. The third word contains the linkage 
■Crandom address pointer! to the next logical block on that 
level 1 if one is present. The remaining words in the record 
are directory entries for directory level records. A total 
of b3 words -CbO words of entries + 3 control words! can be 
used in each record in the directory levels. For the data 
level 1 the control word should be compatible with the 
control words for directory levels. The remainder can be 
any length and format desired. Because of this flexible 
format 1 the processor program must handle I/O of the 
data-level record. However-* if the data-level is con¬ 
structed similar to the directory-level records-* SFS 
functions can be used to perform the I/O. The information 
in all levels is maintained in collated sequence. 
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The control word format is as follows! 

Sg_y?_3S_53_11__Q 

/di_/yic_/yE§__ /qq§ _/fyid__ / 


dl 

s 

data level• 

wir 

= 

words in record■ 

wpe 

= 

words per entry* 

noe 

= 

number of entries 

fwad 

= 

first word address of data entries* 
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This diagram depicts an example of a tree-structured file 
of the type processed by SFS functions* -CThis particular 
example is the same as the layout of the PROFILO file.} 


THEE-STRUCTURE 

file layout. 
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CHN = Primary entries 

- {Charge number for 

PROFILO! 


PN = Secondary entries related to specific primary entry- 
{Project number for PROFILO-> 

UN = Tertiary entries related to specific secondary entry- 
{Control fields and user numbers for PI?-0FIL0-> 
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3»S»5 PROFILO - Special System File 

The PROFILO file contains information required to validate a 
users request for access to charge numbers -Cand project numbers!. 
Because the nature of the information contained on PROFILO 
warrants secrecy t programs that access the file must be run as 
special system jobs to avail themselves of the security provided 
by that feature. PROFILO will reside at the system user index 
as a direct access permanent file. 

Through the UPC featuren three levels of job accounting are 
available: 

1. by user numberi 
S. by charge numberi 
3. by project number. 

UPC provides for mandatory charge number and project number 
validation of user by specifying the CCNR bit in the access 
word {VALIDUS control information! associated with each user 
number. Unless this bit is seti a user is not allowed to do 
anything within the system until his charge number has been 
validated. The validated charge and project numbers are 
written to the accounting dayfile along with the current 
contents of the accounting accumulators {these are not reset!. 

Once a user is validated to proceed within the system-i he may 
change his charge number or project number simply by issuing 
a new CHARGE command. The CHARGE command is also available 
to users who are not restricted by the CCNR biti however-i 
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the parameters will still be validated. {For a description 
of the CHARGE command refer to Section 3.5.5.S}. 

3.2.2.1 PROFILE - Project Profile Manager 

PROFILE provides creationi modification and inquiry capa- 
j bility for the project profile file PROFILO. PROFILO 

contains information required to validate a user's request 
for use of charge numbers {and project numbers}. 

Control card call 
PROFILE{pl=f1Tp2=fE n...npn=fn} 
where pi and fi can be the followings 
£i fi 

I = Input data for 0P=C or 0P=U options. 

I Default is INPUT. 

L = File to receive output. 

I Default is OUTPUT. 

P = Project profile file. 

I Default is PROFILO. 

S = File to receive PROFILO source data for 0P=S. 

j Default is SOURCE. 

OP = Option can be any of the following: 

C = CreateT process input file and create a 

PROFILO file. {Section 3.2.2.1.1.1} 

I U = Updaten update file specified by P option with 

data on input file;*; {Section 3.2.2.!• 1.2}. 

* These options can be run from other than system origim but only by 
the designated master user of the specified charge number. 
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I = Inquire! writes requested information to output 
file.* {Section 3.2.5.1.1.3> 

R = Restructure! the new or rebuilt PROFILO file will 
replace the PROFILO file. {Section 3.5.5.l.l.MJ 
S = Return PROFILO file to source format and place 
j on file specified by the S option. {Section 

3.5.5.1.1.S> 

K = K-display option! all other options are cleared 

and instructions must be entered via the K-display. 
{Section 3.5.5.1.1.b} 

T = Timesharing update! same as U but suppress 
I preliminary instructions.* {Section 3.5.5.I.M.ll 

L = List option! lists selected portions of the 
PROFILO file determined by the LO parameter.* 
{Section 3.5.5.1.1.7> 

Default is U. 

CN = Charge number for inquire. 

PN = Project number for inquire. 

I CN and PN can only be entered for inquire. If 

these parameters are required and are not entered 
on the control card! then the input file is read 
for them. 

LO = can be any of the following: 

F = Full file list of the whole PROFILO file. 

* These options can be run from other than system origin! but only 
by the designated master user of the specified charge number* 
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C = Charge number list of the whole PROFILO file. 

P = Project number list of the whole PROFILO file. 

FM = Full file list of everything accessible on the 
PROFILO file by the master user.* 

CM = Charge number list of all charge numbers 

accessible on the PROFILO file by the master 
user.* 

Pfi = Project number list of all project numbers 

accessible on the PROFILO file by the master 
user.* 

Default is F. 

If no parameters are specified on the control card-i tha 
option is selected as K if from system origin. Only the 
Ui Tt I and L OP options can be selected by jobs which have 
non-system origin type origin types. 


* These options can be run from other than system origin t but only 
by the designated master user of the specified charge number. 
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3.2.5.1.1 OP Options 
3*2*S•1*1.1 Create Option 

The create option can be performed from system origin 
type jobs only- Directives {described in 3.5.2.1.2> 
are read from the specified input file and are pro¬ 
cessed to create entries on the PROFILO file- Dupli¬ 
cate charge numbers or duplicate project numbers per 
charge number entry are invalid during a create run 
and are flagged as errors ■ Default values are set 
for all control values not entered for a project 
number. {For default values see Section 3.B.2.1.2.> 
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3»2»2»1»1»5 The update option can be performed from input file 
directives. Input file directives are identical to 
those for the create option fsee Section 3.S.5.1.SI. 

Iilhen directives are entered for an existing project 
number for a charge numberi the control values are changed 
according to the directives. If the project number 
and/or charge number is not foundn they are considered 
new ones and are added to the PROFILO file. 

I 3 . 5 . 5 .1.1.3 The inquire option requires either the PN and/or CN 

parameters from the control cardn or the project number and/ 
or charge number directives from the input file. If an 
inquiry is performed on a charge number only -Cno project 
number presentln all project numbers for that charge 
number are listed on the output file. If the project 
number is included 1 the control values and all validated 
user numbers for that project number are written to the 
output file. 

Following are examples of the two types of inquire outputs. 
Charge number only inquire: 

VALIDATED PROJECT NUMBERS ARE - 

PROl PR05 

XXXX 
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Charge number/project number inquire: 


CONTROLS FOR PROJECT NUMBER PROB 


CREATE = 7B/0M/11. 

CP = 

BOO 

MODDED = 7B/0M/1B. 

AP = 

10 

TI = Dfi.00.00. 

CT = 

100 

TO = IB.00.DO 

AT = 

S 


USER NUMBERS VALID TO USE PROB 
USERABC USER1B3 


3»B*B»1»1»M The Function oF the reFormat option is to rebuild the 
PROFILO File in order to discard any deleted entries 
and to reconstruct the directory to reduce File accesses 
when attempting to retrieve data From the File. 

3.B.B.1.1.5 The source option provides For the PROFILO File to be 

converted back to source Format -Cdirective images} on an 
input File {SOURCE}* This input File can then be used 
in a create {or update} run at some Future time. 

3*B*B*l*l.b The K-display option allows direct interaction {From the 
console} For inquire and update type operations. All 
directives are now entered via the K-displayn instead oF 
on the input File. The control values For a project 
number are displayed For K-display operations. The 
other output normally retrieved For the inquire option is 
discarded when that type oF operation is perFormed From 
the K-display. {K-display usage is described in the 
KRONOS Operator's Guide.} 
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The K-display option can only be initiated from system 
origin type jobs- The call can be of two types! 

1. PROFILE. 

2. PR0FILE{0P=K} 

This form would normally be used if other parameters 
needed to be included with the call. 
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PROFILO K-DISPLAY {Left Screen Only> 

PROFILO 

CREATED 7B/DL/0t. LAST nOD 72/Ob/Da. 

ALL INPUT DIRECTIVES ARE THE SAME AS THE REGULAR UPDATE 
DIRECTIVES. THE FOLLOWING COMMANDS ARE ALSO PROVIDED- 
/CN - BEGIN ACTION ON CHARGE NUMBER *CN* 

END - TERMINATES INPUT OF DIRECTIVES FOR THE SELECTED 

CHARGE NUMBER, AND UPDATES PROFILO IF SO DIRECTED. 
DROP - TERMINATES INPUT OF DIRECTIVES FOR THE SELECTED 

CHARGE NUMBER, AND PREVENTS ANY UPDATE OF INFORMA¬ 
TION FOR THE CURRENT PROJECT NUMBER. 

STOP - END OF PROCESSING. 


CHARGE NUMBER ABCCHARGEN 

PROJECT NUMBER PROJECTNUMBER123MSb7 

MASTER USER USERABC 

CREATED 72/Ob/Ob. 

LAST MOD 72/Ob/Oa. 

OPT VALUE DESCRIPTION 

TI = DBOO TIME IN - M CHARS NUMERIC 

TO = 1700 TIME OUT - ^ CHARS NUMERIC 

CP = lODOD CP TIME 

AP = Sb3 ACCUMULATED CP TIME 

CT = 100 CONNECT TIME 

AT = M7 ACCUMULATED CONNECT TIME 
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3»2»B»l»]i»7 The list option provides a variety of options for listing 
the information contained on the PROFILO file. The 
available options are designated via the LO parameter. 

The Fi C and P options provide selective information 
from the entire PROFILO filei however-i these listings 
may only be obtained from system origin* The Ffli CM and 
PM options provide the same type of information as the 
previous optionsi howevern the information provided is 
limited to only that information designated as accessible 
by this master user. This master user is defined as the 
account number under which the job is currently being 
executed. Examples of all list options are provided in 
Appendix C. 
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3-2*2.1>2 Input Directives 

The input stream is divided into charge number entries* 
Each charge number entry contains the charge number and 
directives for that charge number* The first card of 
each new charge number entry must begin with a slash -C/D- 
in column 1* The next 1-lD characters must be the 
charge number terminated by a separator* Valid separa¬ 
tors consist of all special characters plus end of line 
or end of card* Directives may follow the separator* 

All data within a charge number entry is free format to 
column 72i howevern directives cannot be split between 
cards or lines* All blanks are ignored* 


Each directive must be separated from the other direc¬ 
tives by one of the separators denoted abovei howeveri 
an equal •£=}• cannot be used to separate directives* 
Directives consist of an identifier followed by a data 
field* The identifier and data field must be separated 
by an equal {=>* 

All directives relative to a charge number must appear 
within the charge number entry* This implies charge 
numbers may not appear more than once in the input stream* 
The data items within the charge number blocks should be 
grouped in project number entries* 
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3.5.S.1.5.1 Example Input Stream 


/CHNUMBEROl 

I1U=USERAA-A 

PN=PR0JECTNUI1BER001 

TI=1500D 

T0=1700]> 

CP=7777B 

UN=USERAAB 

UN=USERAAC 

PN=PR0JECTNUriBER005 

CP=3777B 

UN=USERAAC 

/CHNUMBEROa 

I1U=USERABA 

PN=PR0JECTNUI1BER0Q1 

CT=100I> 

UN=USERAAB 

UN=USERABC 

UN=USERAB]> 

PN=PR0JECTNUI1BER0DM 

/-ETC.- 




/ PROJECT 
f ENTRY 


CHARGE 
r ENTRY 


PROJECT 

ENTRY 


PROJECT ^ CHARGE 

ENTRY y ENTRY 

f 

1 PROJECT J 
ENTRY 


Numeric data is assumed decimal unless •followed by one 
o'f the radix charactersn D {= decimal} or B •£= binary 
or octal}. 
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3»S.2»1.5.1 Data Identifiers 
Keyword Data 

nU = Master user number which has the ability to 
inquire about or update data within the 
charge number record. The master user number 
has implied permission to use any of the 
project numbers defined for that charge 
number. 

1-7 alphanumeric characters. 

1 entry per charge number records. 

This user number is that which is specified 
on an ACCOUNT card or when logging in. 


PN = Project number. 

1-SD alphanumeric characters. 

UN = User number validated to use this project 
number. If no user numbers are specified 
for a project numbern then all user numbers 
are allowed to use it. 

1-7 alphanumeric characters. 
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Keyword Data 

TI = Time of day {Expressed in military time 

notation} before which the validated user 
can not use this project number.* 

M numeric digits + radix. 

Maximum value is BMQOD. 

TO = Time of day {expressed in military time 

notation} after which the validated user can 
not use this project number.* 

M numeric digits + radix. 

Maximum value is 5^0□D. 


* Refer to Section 3.B.2.B for use of these control fields by CHARGE. 
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CP = Total amount of central processor time Cin CP seconds! 
this project number is allowed to accumulate.« 

1-lD numeric digits + radix. 

Oefault = IDDB} 

AP = Central processor time -Cin CP seconds} this project 
number has accumulated.** 

1-10 numeric digits + radix. 

CT = Total amount of accumulated time -Cin seconds} users are 
allowed to be connected to this project number.* 

1-lD numeric digits + radix. 

Oefault = 1008} 

AT = Connect time -Cin seconds} this project number has 
accumulated.** 

1-10 numeric digits + radix. 

DC = Delete charge number. -CUpdate directive only} 

DP = Delete project number. CUpdate directive only} 

DU = Delete user number. CUpdate directive only} 

Default on all directives is zero unless specified other¬ 
wise. 

* Refer to Section 3.5.S.2 for use of these control fields by CHARGE. 

** Refer to Section 3.5.5.3 for use of these control fields by PROJECT. 
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3.2-2«l»3 Error Messages 


3.2.2»1-3.1 System Error Messages 
* DATA BASE ERROR.» 

Format of attached PROFILO file is in error {bad control 
word>. 


=« LEVEL-3 DATA BASE ERROR.* 


Format of file on data-level is in error {bad control 
word>. 


3.2.2.1.3.2 Dayfile Messages 

* ERROR IN PROFILE ARGUMENTS.* 

Error on control card. 

* NO INPUT FILE.* 

No directives present. 

* PROFILE ABORTED.* 

Error flag set at control point. 

* DIRECTIVE ERRORS.* 

Examine output file for reason error occurred. {See 
Section 3.2.2.1.3.33’ 


* ILLEGAL PROFILE INQUIRE.* 

User not allowed to access control information for 
charge number supplied. 
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* PROFILO CREATED.* 

Creation run complete. 

» PROFILO UPDATED.» 

Update run complete. 

» INQUIRY COMPLETE.» 

Inquire run complete. 

* REFORMAT COMPLETE.» 

Reformat complete. 

» PROFILO TO SOURCE.=» 

Source run complete. 


* LIST COMPLETE.* 

List of PROFILO complete. 

3.5.H.1.3.3 Diagnostics to Output File 

ERROR IN CHARGE NUflBER 

Format error in charge number {not 1-10 alphanumeric 
characters}. 

Action Taken: 

That charge number entry is disregarded and PROFILO skips 
to next charge number entry in the input stream. 
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**** DUPLICATE CHARGE NUfIBERS 

This error can only occur during the "create" run* Two 
charge number entries referring to the same charge number 
are found.* 


* Two charge number entries with the same charge number are legal 
during "update" runs. 
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Action Taken: 

All charge number entries after the first one with that 
charge number are disregarded! all other charge number 
entries {that do not contain duplicate charge numbers! 
are processed normally. 

»»»» DIRECTIVE ERROR 

This error can only occur during the "create" run-i a 
delete directive {DCt DP or DU! was encountered during 
a "create" run* 

Action Taken: 

The delete directive is ignoredi all other directives 
are processed. 

»»»» DUPLICATE PROJECT NUUBER 

This error can only occur during a "create" runi two or 
more project number entries within a charge number entry 
refer to the same project number. It is illegal to enter 
the same project number more than once for a particular 
charge number during a create run. 

Action Taken: 

All duplicate project number entries after the first one 
are disregarded! all other project number entries {that 
do not contain duplicate project numbers} are applied 
normally. 
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»»»» DUPLICATE USER NUHBER 

This error occurs when the same user number •CUN> directive 
appears more than once within a project number or an 
update attempts to add a user number that already exists 
under that project number. 

Action Taken! 

The entire project number entry containing the duplicate 
user number is disregarded. 

**** ERROR IN IDENTIFIER 

This error occurs when an unrecognized directive identi¬ 
fier is encountered. 

A ction Taken! 

The action taken is dependent upon the position of the 
error within the entry. 

1. If the error occurs within a project number entry t 
the entire project number entry containing the error 
is disregarded. 

5. If the error is in a directive that occurs -Cwithin the 
the change number entry!after the charge number but 
prior to the first project number {usually an error 
in the hUi DCt DP or first PN directive}! only the 
erroneous directive is disregarded. However! if the 
error is made on the first PN directive! the entire 
project number entry will eventually be disregarded 
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because the subsequent directives for that project 
number entry will be treated as project number entry 
directives that preceed the first PN directive and 
be ignored. 

3. If the error occurs in any PN directive but the first 
one-t it is treated as an error within the preceeding 
project number entry. Both the project number entry 
for the erroneous project number and the preceeding 
project number's entry are disregarded. 

t*** USER NOT VALID TO UPDATE 

This error can only occur during an "update" run when 
the user number of the person attempting the PROFILE 
update run is not the master user number for that charge 
number entry. 

Action Taken: 

That charge number entry is disregarded and PROFILE 
skips to the next charge number entry in the input stream. 

MULTIPLE MASTER USER NUMBER 

This error can only occur during a "create" run when more 
than one MU directive is encountered within a charge number 
entry. 

Action Taken: 

All master user number directives after the first one are 
disregarded. 
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»»»» ERROR IN NUMERIC DATA 

This error occurs when non-numeric data or numeric data 
exceeding the maximum limit for that value is encountered. 

All directives with numeric data limitations occur as 
project number directives. 

Action Taken: 

The entire project number entry containing the directive 
with the numeric data error is disregarded. 

*»»» ERROR IN PROJECT NUMBER 

This error occurs when the data field of the PN directive 
contains a format error -Cnot 1-2D alphanumeric characters!. 

Action Taken: 

The project number entry associated with the erroneous 
project number is disregarded. 

**** ERROR IN USER NUflBER 

This error occurs when the data field of the UN directive 
contains a format error {not 1-7 alphanumeric characters 
or asterisk {*>}. 

Action Taken: 

The entire project number entry containing the bad UN 
directive is disregarded. 
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**** ERROR IN MASTER USER NUMBER 

This error occurs when the data field of the MU directive 
contains a format error -Cnot 1-7 alphanumeric characters 
or asterisk ■[*}>. 

Action Taken: 

Entire charge entry is disregarded and PROFILE skips to 
next charge entry. 

3.5.2.1. M PROFILE Execution from a Terminal 

PROFILE provides three options for a timesharing user to 
use to communicate with the PROFILO file. These options 
are update ■C0P=U>-. inquire {0P=I>-. and list {0P=L>. In 
order to use these optionsi the user must be the designated 
master user of the charge number to be acted upon. {0P=U 
is the default option for timesharing.} 

3.5.5.1. M.1 Update from a Terminal 

The timesharing user can initiate an update by issuing 
the command PROFILE. {This command is available only 
under the BATCH subsystem.} Once initiated! a block 
of data is output to the terminal describing the format 
of directives to be input by the user. The user is 
then queried for a charge number. The user enters 


AA 5777 


pmmtDMu&A. 



CONTROL DATA CORPORATION 

---DIVISION 

DOCUMENT CLASS_EES_ PAGE NO V 3E Rev A 

PRODUCT NAME_ KRONOS 5.1 .. . 

PRODUCT MODEL NO_ £066*5.1 _MACHINE <:prifs fc»DPQ/QC CYBER 75-»7 3i7H 


directives 1 a line at a time. To terminate inputi a 
blank line is entered. 


The block of directive information output to the 


terminal is as follows: 

FOLLOUINC ARE THE VALID INPUT DIRECTIVES 
FOR UPDATE - 

PN = PROJECT NUMBER 
UN = USER NUMBER 
TI = TIME IN 
TO = TIME OUT 

CP = MAXIMUM CENTRAL PROCESSOR TIME 
AP = ACCUMULATED CENTRAL PROCESSOR TIME 
CT = MAXIMUM CONNECT TIME 
AT = ACCUMULATED CONNECT TIME 
DC = CHARGE NUMBER TO DELETE 
DP = PROJECT NUMBER TO DELETE 
DU = USER NUMBER TO DELETE 
A BLANK INPUT LINE TERMINATES THE 
UPDATING OF THE GIVEN CHARGE NUMBER. 

The timesharing user can suppress this block from 

being output by specifying the control card option 


0P=T. The T option is exactly the same as the U 
option 1 except T suppresses output of the above 
block. 


3.B-5.1.M.5 Inquire from a Terminal 

The timesharing user can request information on valid 
charge numbers and project numbers by issuing the 
command PROFILEiOP=I-iCN=xxx-iPN=yyy. If either the 
charge number or project number is not entered on 
the control cardi the system requests the user to 
enter them. If no project number is entered-) then 
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all valid project numbersi for the entered charge 
number! are output to the terminal. If both charge 
number and project number are entered! then the 
control values and all valid user numbers! for that 
project number! are output to the terminal. 

If a charge number is required and one has not been 
supplied! PROFILE outputs 
ENTER CHARGE NUMBER 

to the terminal and then waits for the user to type 
in a 1-lD character charge number. If a null line 
is entered! it is treated as End-of-File. 

If a project number is required and one has not been 
supplied! PROFILE outputs 
ENTER PROJECT NUMBER 

to the terminal and waits for the user to type in a 
1-20 character project number. If a null line is 
entered! it indicates end of processing for the 
current charge number. 

If no project numbers are given for a charge number! 
then all valid project numbers for the current charge 
number are output. PROFILE then requests the next 
charge number. For each project number provided! the 
control information for that project number is output 
to the terminal. 
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3.2»2»1»M»3 List from a Terminal 

See Section 3.2*2*l«l-7 for a description of the list 
options available to the master user. 


AA 3777 


PRMTBDmuSA 



CONTROL DATA CORPORATION 


-DIVISION 

DOCUMENT CLASS__ PAGE no V 3M _ 

PRODUCT NAME_ KRONOS g.l __ 

PRODUCT MODEL Nin ED6fl*S.l _ MACHINE CYBER 75t7 3i7M 

3^S•3^^ CHARGE 

CHARGE provides validation of the entry of a user's charge 
and project numbers against system resources used* A call 
to CHARGE will be required for the use of the system 
unless a bit CCCNRl in the user's access word is set -Crefer 
to Chapter 6 in the KRONOS S*0 Operator's Guide for an 
explanation of the access word>. 

Validation consists of several steps: 

1* The user profile validation file -CPROflLO} is searched 
for the change and project number combination* If 
found 1 

5* The validation project record is checked for a list 
of user numbers that may use it* If any of the 
following three conditions are met: 
a* no list is provided 
b* the user is on the list 
c* the user is the master user 
then 1 

3* The validation record is checked for remaining: 
a* CPU time 
b* Connect time 

if both values are greater than zeroi 
M* The time of day is checked for a value that is 
within limits specified for this record* 
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If the validation process fails for any of the above checksi 
the user's job is aborted and an appropriate error message 
issued to the dayfile {refer to Section 3.S-5»B.S for specific 
error messages}. If the user is at a terminal•> this message 
is returned to the terminal. If validation is successful! 
the following events occur: 

1. Accounting information for all system resources used is 
written to the accounting dayfile {refer to Appendix B 
for message formats}. Values indicated for resources 
are cumulative. 

2. The charge and project numbers are written to the account 
file {see Section 3.B.E.E.H for message format}. 

3.B.B.B.1 Terminal Usage 

When a user logs in at a teletype! the account number he 
enters and is validated for may have an associated access 
word that indicates that he is required to enter a charge 
number and project number. If this is the case! the user 
will not be allowed to enter any TELEX commands except 
CHARGE! LOGIN! HELLO! GOODBYE! and BYE! until he has 
entered a valid charge number and project number. 

The message; 

TERMINAL NNNN 

I recover/system: 

appears at the terminal. 
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If the user is not required to enter a charge number-i 
then the following message appears at the terminal: 
RECOVER/CHARGE: 


AA 3T77 


PRINTCOmUSA 



CONTROL DATA CORPORATION 


DIVISION 


DOCUMENT CLASS_ 

PRODUCT NAME_ 

PRODUCT MODEL NO. 


ERS 

KRONOS E.l 

Eaaa*2.i 


PAGE NO- 


MACHINE bOOG/GDC CYBER 72n7 3-.7M 


If the user is validated {through the account number} 
that he must enter a charge number and he does noti 
the message: 

CHARGE REdJUIRED 

will be returned to the terminal, (tlhen valid charge and 
project numbers have been entered and valid response re¬ 
turned the user may begin his normal teletype session- 

The user can enter another valid CHARGE command at any 
time during the session. The terminal CHARGE command 
activates the charge program which performs validation 
and issues accounting messages as described above. 

3.2.5.S.S Batch Usage 

When a batch job enters the systemi the second card is 
expected to be an account card and is validated. If 
the user's validation control indicates CHARGE is required-i 
the card immediately following the account card must be a 
CHARGE card. Alson on any subsequent account card i if 
job profile validation is requiredi a CHARGE control 
card must follow. Subsequent CHARGE calls may appear in 
the control card stream. If the batch user is not 
required to have a charge control cardi he also may enter 
a charge control card anywhere in his control card record 
after his first account card. In any casen the charge 
and project numbers must be valid as described by the 
validation procedure {3te.Ste}. 
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3.5-2-5»3 Control Card Call 

CHARGE -CchangenmbrT projectnumberJ 

changenmbr = Charge Number {I-ID alphanumeric 

characters} 

projectnumber = Project Number -Cl-BQ alphanumeric 

characters} 


3.S»S»2*M Account File Messages 

Charge and project numbers can be entered at any time 
during the course of a run- A "CHARGE" control card call 
causes all accounting information to this point to be 
issued to the account file. 


This includes normal accounting messages - CPn CMi MSt MT 
{see *lCj5t: documentation {Appendix B}t for detailed explan¬ 
ations of these messages}. These are followed by: 

1} 21} 27} 

* yy.mm.dd. hh.mm.ss.CH chargenumbriprojectnumber* 

This charge-project number combination can be used for 
accounting purposes for this job until another *CH* entry 
occurs or until job termination. 


3.2.2.2.S Error Messages 

* ILLEGAL CHARGE.» 

1. Charge or project number does not exist. 

2. Project number is not available to a user with this 
account number. 
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» DATA BASE ERROR.» 

Error in validation file structure detected. Contact 
an on-site analyst immediately. 

* CHARGE ABORTED.* 

External job abort. 


* ILLEGAL CONTROL CARD.* 

No terminator was found on control card* 

* CHARGE FILE BUSY.* 

File is not available for charge purposes. Uait and 
try again. 

* NO CPU TIME AVAILABLE.* 

Central processor time allowed under this project 
number has been expended. 

* NO CONNECT TIME AVAILABLE.* 

tty connect time allowed under this project number has 
been expended. 

* CHARGE ILLEGAL AT THIS H0UR.» 

This project number cannot be used at this time of day. 
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3.e.2.3 PROJECT* 

Usage of certain machine resources -Ccurrently CPU and 
connect time> by CHARGE and PROJECT number is accumulated 
in the user profile control file -CPROFILO}. Since the 
overhead of dynamically updating these resources would be 
excessive 1 a routinei PROJECTi is provided to scan the 
accounting dayfile from the point PROFILO was last updated 
and update all project records. 

Resource usage is traced by scanning the accounting dayfile. 

One pass is made. During this passi information pertinent 
to any job which might validly use charge and project 
numbers is recorded by PROJECT- This includes information 
such as job namei account numberi charge and project 
numbers 1 accumulated value and last dayfile value for all 
resources to be charged. As PROJECT accumulates datai it 
updates the user profile validation file -CPROFILO}. 

So that a dynamic recording of system resources may be 
approached-! PROJECT saves accumulated data of incompleted 
jobs and records their position of the account file at the 
end of a scan. This data is retained on a permanent file 
-CPROVARE} under the system account number. All data for 
completed jobs is written to the validation file. On the 
next scan of this account file-i data already accumulated 
will be recovered and the account file will be positioned 

to the previous stopping point before the scan continues. 

* PROJtCT will be provided only if time and resources allow. 
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3«S«S«3«1 Control Card Call -CSystein Origin Type Only} 

PROJECT{P=accfile} 

accfile. = Local file to scan for accounting dayfile 
messages. If none is specified! the 
system accounting dayfile will be accessed. 

3.S.S.3.2 Error liessages 

» ACCOUNT FILE ERROR.» 

An illegal entry was found in the accounting dayfile. 

* PROJECT ABORT.* 

Abnormal program termination was caused externally - by 
operator drop or illegal system request. 

* DATA BASE ERROR.» 

Bad information was encountered on user profile 
validation file -CPROFILO}. Contact an analyst 
immediately. 

* TABLE OVERFLOli).* 

An attempt was made to expand managed tables beyond a 
predefined field length limit. Currently bODQDB. 

» ERROR IN ARGUMENTS.* 

.An illegal parameter was encountered on the control 
card. 


AA 3777 


ffllNISmUSA. 



CONTROL DATA CORPORATION 

_- . ..DIVISION 

DOCUMENT CLASS__ PAGE NO V _ 

PRODUCT NAME _ KRONOS S.l _ ' _ 

PRODUCT MODEL NO_ E06fi*S«l _MACHINE CYBER ?Bi7 3t?H 


» JOB INF0RI1ATI0N FILE BAD.* 

Invalid information was found on the job save file 
■CPROVAREl. 


■CPFfl Error Message! 

PROJECT will issue any PFfl error messages returned. 

* JOB TABLE ERROR.* 

An error has occurred in managed table processing. 
Contact an analyst immediately. 

* ILLEGAL CONTROL CARD.* 

A call was made from other than system origin. 
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3.5«3 VALIDUS - Special System File 

To understand this sectioni the reader should be familiar with 
Chapter fi of the KRONOS 5.D Operator's Guide. 

Information contained in the VALIDUS file is basically the same 
as in KRONOS 5.0. Two additional bits CCCNR-i CSTP} exist in 
the access word. When not seti CCNR requires the user to enter 
valid charge and project numbers before he can access the system 
■Crefer to Section 3.5.5>. CSTP allows the user to access 
special transaction functions. Three fields have been added 
to those available under KRONOS 5.0 which contain additional 
permanent file controls. Resources which can be controlled and 
their associated directive identifiers include number of indirect 
access files CFOi total number of sectors allocated for indirect 
access files space {CS>t and number of sectors allocated to any 
single indirect access file {FSJ. Four fields have been added 
to describe the terminal which is normally used — even or odd 
parity -CPAJi number of rubouts fROli half or full duplex {PX>i 
and terminal type -CTTl. The internal structure of the VALIDUS 
file conforms to a structure which allows access through the 
routines provided by the Special System File Supervisori SFS 
{refer to Section 3.5.11. The file structure is illustrated in 
the accompanying diagram. Because the nature of the information 
contained in VALIDUS warrants secrecy t programs that access the 
file must run as special system jobs. VALIDUS will reside at 
the system user index as a direct access permanent file. 
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3.2.3.1 nODVAL 

nODVAL interfaces the System File Supervisor -CSFS}. Since 
MODVAL runs as a special system jobi the system commandsn 
PASSUOR and LlfllTSi are processed directly by MODVAL tsee 
Sections 3.2.3.2 and 3.2.3.3}. The following sections 
describe external feature modifications: 

3.2.3.1.1 MODVAL Usage 

The information displayed on the console screens differs 
slightly from that provided in KRONOS 2.Q. The new format 
is illustrated on the following pages. The "initial" screen 
contains instructions for the use of the END-i STOP and DROP 
commands in addition to information currently displayed-) 
and it appears on the right screen at all times. 

The left screen operates as under the KRONOS 2.0 system. 

In addition to the KRONOS 2.0 options on the initial display 
■CI-i Cn U and D}-i the slash -C/} has been added and is similar 
to the U option except thati if the account number is not 
found-) a new account number will be created automatically. 

It is possible under this option to switch control directly 
from one account number to another without returning to the 
initial screen. The format is similar to the first card of 
a MODVAL input directive record: 

/ACCNUMB CR 
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If the slash {/} directive is used exclusively-) data entry 
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VALIDUS File Structure 


LEVEL-0 


* * 
*AN1 * 

* 2i* 

*AN7 * 

* 2* 


* ... * 


LEVEL-1 

^1 


t * 

*AN1 * 

* 3>|: 

*AN5 * 

* ... * 

* * 




DATA-LEVEL 

3 

*C0N TR0£ 
*BL0CK1* 
*C0NTR0£ 

^BLOCKS* 

^ ^ 

t ... * 

* *. 


• H H 

i^U 4^U 

9 ^p 


* * 

»AN7 * 

^ I 45 K • • • 

*AN6 * 

^ ■. . ^ 

* ... ** 

* * * 

^ • ' 


=^C0NTR0S 

*BL0CK7^ 

^CONTROE 

*BLOCK^* 

* ... * 
^ ... ^ 

* Jfc 


AN{I> — Primary entries. 

CONTROL BLOCKCI} — Secondary entries related to specific 

primary entries. 
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VALIDUS 


create:]) 7S/0S/01. 

UPDATED ?2/0b/DS. 

INPUT DIRECTIVES ARE THE SAME AS BATCH INPUT DIRECTIVES. 
THE FOLLOWING DIRECTIVES ARE ALSO PROVIDED - 

/AN - TERMINATE INPUT FOR PRESENT ACCOUNT 

NUMBER IF ANY AND UPDATE VALIDUS FILE. 
INITIATE ACTION ON ACCOUNT NUMBER ^kU*. 

InAN - IN(3UIRE OPTION. THIS DISPLAY ONLY. 

CiAN - CREATE OPTION. THIS DISPLAY ONLY. 

UiAN - UPDATE OPTION. THIS DISPLAY ONLY. 

D-.AN - DELETE OPTION. THIS DISPLAY ONLY. 

END - COMPLETE UPDATE OR INQUIRE OF ACTIVE USER. 

FROM THIS DISPLAY, END RUN. 

DROP - TERMINATE INPUT FOR ACTIVE USER. 

STOP - TERMINATE INPUT FOR ACTIVE USER. IF ANY, 

END RUN. 

AN = 1-7 CHARACTER ACCOUNT NUMBER. 

DATA ENTRY FORMAT IS OF THE FORM MT=XX, PR=XX, TL=XXXX, 
ETC. ALL NUMERIC FIELDS ARE ASSUMED TO BE DECIMAL 
UNLESS A POST-RADIX IS SPECIFIED. FOR EXAMPLE - 

ACCESS WORD IDENTIFIERS MOODS STARTING AT BIT 0 ARE - 
CPWC CTPC CLPF CSPF CSOF CASF CAND CCNR CSTP 

CREATING PGMMODS. 


INITIAL DISPLAY 
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ACCOUNT PGimODS 


CREATED 


?a/D7/oa. 


UPDATED 


7B/D7/0a. 


FIELD 


TYPE 

CONTENTS 

PASSWORD 

0-7 

CHARACTERS 

PW = ABCDE 

USER INDEX 

1-377777B 

UI = 117B 

ANSWER BACK 

0-10 

CHARACTERS 

AB = AAAAA 
BBBBB 

ccccc 

DDDDD 


MAG TAPES 
REMOVABLE PACKS 
TIME LIMIT 
JOB PRIORITY 
CENTRAL MEMORY 
NUMBER OF FILES 
MASS STORAGE 
DEFERRED BATCH 
INDIRECT FILES 
INDIRECT SPACE 
INDIRECT SIZE 
TERMINAL PARITY 
NUMBER OF RUBOUTS 
TRANSMISSION 
TERMINAL TYPE 
PROJECT NUMBER 


Q-b3 MT 
D-b3 RP 
0-Sll TL 
0-t3 PR 
0-MDDQB CM 
Q-na NF 
D-aoMa MS 
D-tj3 DB 
Q-777777B FC 
0-777777B CS 
0-777777B FS 
3-M CHARACTERS PA 
D-37B RO 
M CHARACTERS PX 
3-b CHARACTERS TT 
0-lD CHARACTERS PN 


t. 

3 

lOO 

30 

lOODB IN 100s 
30 
100 
10 

SYSTEM 

5000 

UNLIMITED 

EVEN 

SYSTEM 

HALF 

TTY 

310Q3a 


ACCESS WORD 


CHARACTERS 


Alii = 00000000000000000131 


SECOND DISPLAY 
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3.5.3.1«S I “Option 

The I-Option can no longer be used to update an account 
record. Processing will always proceed as if a "DROP" 
command had terminated data entry for that account number. 

The "U" option or the "/" option must be used to update 
existing records. The "STOP" command will not only 
terminate entry for an active account number without a 
VALIDUS update! but will always complete and terminate 
the MODVAL session entirely. 

3^2.3.1.3 MODVAL Utility functions 

In addition to the files listedi the following file names 
may be changed with the identifiers U and L! 

VALINDX 

File that contains available user indices for the 
VALIDUS file being manipulated. This file is built 
by MODVAL and must be present as a local file for U 
and R options. 

OUTPUT 

File to receive list output. 

3.S.3.1.M File Creation ■C0P=C} 

In addition to the present separator characters! end-of- 
card or end-of-line will be recognized. Thus! if an input 
directive occurs last on a card! no comma {!> or other 
separator character need follow it- For example: 
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/ROBERTRn AIj 1=CSPF 
Ayj=CLPF 

is legal. Noten howevern that it is no longer acceptable 

to lap data from card to card. For example: 

/ROBERTR-, AU=CSPF-,Alii= 

CLPF. 

is illegal. 

Values provided for the UI identifier will not be checked 
for duplication if they are greater than 377700 octal 
•[system assembly constant AUIMX}. Likewise•> values 
providedT when the UI identifier is not used for an 
account numberi will not extend beyond this value. 

3.2.3.1.5 Restructure Option •C0P=R} 

Permanent files for deleted users are not purged from 
the system until the restructure option is selected and 
all users having that user index have been deleted. The 
user indices purged are listed by MODVALi howeveri no 
attempt is made to list users who were assigned those 
indices. No files under user indices above 377700 octal 
are purged. 

3.2.3.1.b Error and Informative Messages 

The following three sections describe dayfile and output 
file messages-! most of which are . substantially 
different from those issued by MODVAL under KRONOS 2.0. 
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3.2»3»l-t>»l Dayfile Error Messages 
» DATA BASE ERROR.» 

A control word in the validation file is in error. If 
the problem persistsi consu-lt aF\ analyst. 

» SYSTEM ERROR.» 

Indicates an internal malfunction due to either software 
or hardware. Consult an analyst immediately. 

» ERROR IN PASSUOR ARGUMENTS.» 

Invalid control card arguments. Correct and rerun. 

» ERROR IN MODVAL ARGUMENTS.» 

Invalid control card arguments. Correct and re-run. 


» MODVAL ABORTED.* 

Control point error flag is set. Consult dayfile 
listing for reason. 

» DIRECTIVE ERRORS.* 

Errors were encountered on the input file for either 
create or update modes. Consult the output file for 
specific errors. 

» ILLEGAL CONTROL CARD.=» 

User is not validated to change password. 
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3*S>3<l*b«5 Error Messages to Output File 

Corrective action is governed by the severity of the 
errors. The job may be re-run or the new validation 
file corrected at the user's discretion. 

*»»» ERROR IN ACCOUNT NUMBER. 

Illegal data was encountered where account number was 
expected. 

Action Taken: 

That account number entry is disregarded and *M01>VAL* 
skips to the next account entry. 

»»»» DUPLICATE ACCOUNT NUMBER. 

That account number has been entered previously. Occurs 
only from create run. 

Action Taken: 

The first entry is used. 

»»»» ERROR IN IDENTIFIER. 

Illegal parameter identifier encountered. 

Action Taken: 

That account number entry is disregarded. {From 
K-Display-i only that line of input is disregarded.} 
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ERROR IN NUMERIC DATA. 

Can indicate any of the following conditions! 

1. Numeric data not numeric. 

5> Data exceeds maximum. 

3. No data present. 

Action Taken! 

That account number entry is disregarded. -CFrom 
K-Displayi only that line of input is disregarded.} 

ERROR IN ALPHANUriERIC DATA. 

Can indicate! 

1. No data present. 

5. Data for identifier unrecognized. 

3. Number of characters exceeds maximum allowed. 

Action Taken! 

That account number entry is disregarded. {From 
IC-Displayi only that line of input is disregarded.} 

USER INDEX PREVIOUSLY DEFINED. 

No more than one account number can be assigned to 
any user index with the "UI" keyword. 

Action Taken! 

That account number entry is disregarded unless the CV 
parameter is selected. Then the duplication is flagged 
on the output file and processing continues normally. 
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**** NO USER INDICES AVAILABLE. 


No more user indices are available for automatic assign¬ 
ment. The FUI directive must be used to specify user 
indices. 


Action Taken: 

That account number entry is disregarded. -CFrom K- 
display-i only that line of input is disregarded.! 
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3<2«3«]fti>3 Informative Messages 
♦ CREATION COMPLETE.* 


Self explanatory. 


* UPPATE COMPLETE.* 

Self explanatory. 

* REFORMAT COMPLETE.* 

Self explanatory. 

* CONVERSION TO SOURCE COMPLETE.* 

Self explanatory. 

* INQUIRY COMPLETE.* 

Self explanatory. 

* CATALOG COMPLETE.* 

A list run is complete. 

* nnn USER INPICES PURCEP.* 

All files under nnn user indices were purged via the 
reformat option. System origin only. 

* LEVEL-1 INPEX BLOCKS LINKEP.* 

If account file can be reformatted to eliminate block 
linkage! searches will be faster — 

1. For account numbers residing in linked blocks, 
a. For non-existent account numbers which would have 
resided in linked blocks. 
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* CREATING account.* 

User number "account" is being created. 

* UPDATING account.* 

User Number "account" is being updated. 
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K-Display Operator Messages 
»»»» FORMAT ERROR. 

Entry is unrecognizable. 

Action Taken: 

That line of input is disregarded. 

* INQUIRING account.* 

An inquire operation is in progress for user "account”. 

*■ DELETING account.* 

User "account" is being deleted from the VALIOUS file. 

* account CREATED.» 

User "account" has been created. 

» account UPDATED.» 

User "account" has been updated. 

* account IN(3UIRED.» 

User "account" has been queried. 

* account DELETED.* 

User "account" has been deleted from the VALIDUS file. 
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3.2.3.1.7 VALIDUS File Conversion 

An additional control card parameter {CV> has been added 
that suppresses automatic creation of system and library 
user indices•» and allows creation of two account numbers 
having the same user index during a create run. This 
allows source output from KRONOS 2.0 NODVAL to be used as 
input for a creation run under KRONOS 2.1 flODVAL* Thusn 
to convert a KRONOS 2.0 validation file to KRONOS 2.1 
formatT one would return his VALIDUS file to source format 
using a copy of KRONOS 2.0 MODVAL and use the source file 
as input to a KRONOS 2.1 MODVAL* Since MODVAL no longer 
allows input directives to overlap cards {see Section 
3.2.3.1.Mil a user who wishes to work with a file that 
contains such input directives! should use it to create a 
dummy VALIDUS which is then returned to source under KRONOS 
2.0 MODVAL. This will provide a source input which KRONOS 
2.1 MODVAL can read. 


The CV parameter can also be used with the KRONOS 2.1 MODVAL 
to suppress KRONOS 2.1 type identifiers during a conversion 
to source run to allow conversion from 2.1 to 2.0 format 
via a source input file. 
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3.g.3.1.a Additional Control Card Parameters 

Several additional capabilities have been added to MODVAL 
for KRONOS S.l. 

3«5«3ali*fi«l CV Parameter 

Refer to the previous section for a description of this 
parameter. 

3.5.3.1. fl.2 0 Parameter 

If specified! flODVAL will not abort when directive errors 
are detected. 

3.3.3.1. fi.3 OP Parameter 

Three new options have been provided. 

3.3.3.1. fl.3.1 OP = Zi Card Update Option 

Directives following the terminator on the NODVAL 
control card are processed similarly to the U option. 
However! the system validation file is updated. This 
option clears all others {except K-display> and 
requires system origin type to run. 

3.3.3.1. a.3.3 OP = l! Inquire Option 

Validation fields are listed from the system validation 
file for the account specified by the last account card 
or by terminal login. This option identifier must 
occur alone. An example of output generated appears 
as follows! 
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PROFILE bS 75/06/55. 75/06/55. 

AB =■. 

AB =1 
AB 

AB =1 

MT = M-. 

RP = Ml 

TL = 7777B-. 

PR = 70B-. 

CH = 1000B-. 

NF = 50-. 

ns = 1001 

PN =•. 

OB = 10-. 

FC = SYSTEn-i 

CS = SYSTEn-i 

FS = SYSTEn-. 

PA = EVEN •, 

RO = 31-. 

PX = HALF 

TT = TTY 1 

AU = 00000000000000000177 


3.5«3.1.6.3.3 OP - Li List Option 

Catalog and list validation file entries by account 
number or user index {order is specified by the LO 
parameter}. Account number-i user indexi creation and 
last modification dates will be listed. Normally the 
system validation file is catalogedi although the LO = L 
parameter can be used to specify a local file. Uhen 
the system file is catalogedi this option requires 
system origin type to run. The L option identifier 
must occur alone. An example of output generated 
appears as follows: 
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ACCOUNT 

USER 

CREATION 

LAST MOD 

NUMBER 

INDEX 

DATE 

DATE 

ROBERTR 

1 

72/oa/ss. 

72/0a/2S. 

UHOOPEE 

S 

72/0a/5S. 

72/0a/2S. 

UAROELL 

3 

72/0a/2S. 

72/0a/2S. 

LIBRARY 

37777b 

72/Da/2S. 

72/0a/2S. 

SYSTEMX 

377777 

72/Da/2S. 

72/0a/2S. 

3.S.3.1.a. 

M LO Parameter 



This parameter can be used to specify list options which 
can be any of the following: 

LO = El list errors only fused with OP = C-i Ui or Z>. 

LO = At sort by account number fused with OP = L>. 

LO = Nn sort by user index fused with OP = L}. 

LO = Ln catalog local file fused with OP = L>. 


LO = AL and LO = NL are valid. Omitting the LO parameter 
is equivalent to LO = A flist all directives! or sort the 
system file by account number!. Selecting LO with no 
letters is equivalent to LO = EN flist only errorsi or 
sort the system file by account number}. 
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Additional Input Directives 

Three identifiers have been added to those available under 
KRONOS 2.0 which manipulate permanent file controls -CFCn 
CSi FS>. An entered value of zero -CQ} indicates that the 
system will use a predetermined value for the user's origin 
type. An entered value greater than a system defined v^lue 
indicates that no limit will be imposed. For further 
informationT refer to the Permanent File Manager ERS. 

Data fields for these identifiers can be any decimal or 
octal -CD or B post radix may be usedi no radix indicates 
decimal} value from 0 to 777777B. Each identifier should 
occur only once per account number record. 

Identifier Data 

FC = File count. Maximum number of indirect 

access permanent files. 

CS = Cumulative space. Maximum number of sectors 

allowed for all indirect access permanent 
files. 

FS = File size. Maximum number of sectors allowed 

for any single indirect access permanent file. 
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Four identifiers have been added which manipulate fields 
describing the user’s terminal. 


Identifier 

PX 


Pata 


Transmission Mode. Terminal operates in 
full or half duplex mode. Only one entry 
should occur per account number record. 
The following values are available: 


Value 


Explanation 


FULL System enters echoplex mode auto¬ 
matically. 


HALF System does not enter echoplex 

mode automatically. 


RO = Rubout count. Character count delay asso¬ 

ciated with the user's terminal. A value 
of 37B denotes that the system-will use the 
default number for the user’s terminal type. 
One value from 0 to 37B may be entered for 
each account number record. 


PA = Terminal parity. Terminal operates with 

even or odd parity. One of the following 
two values may be entered for each account 
number record: 


EVEN 


OOP 

TT = Terminal type. One of the following values 

may be specified for each account number: 

Value Explanation 

TTY Teletype or other ASCII compatible 

terminal. 

MEMAPL MEMOREX 12MQ with APL print. 

COR Correspondence with standard print. 

CORAPL Correspondence with APL print. 
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3.S.3.5 PASSWOR Control Card 

flODVAL will process the PASSUOR control card directly at 
the user's terminal or batch job via the special system 
access feature described in Section 3.1. 

3«2.3.5*1 Control Card Call 

PASSyOR Coldpw-inewpwl 

Change user account password *oldpw* to *newpw*. 

User previously must have either: 

1. Logged in on a terminal. 

2. Issued an account card. 

to provide an account number which is validated to 
change password. 

3.2.3.2.2 Error Messages 

» ERROR IN PASSyOR ARGUMENTS.» 

Invalid control card arguments- Correct and re-run. 

* ILLEGAL CONTROL CARD-* 

User is not permitted to change password. Must acquire 
such validation. 
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3.2.3.3 LIMITS Control Card 

MODVAL will process the LIMITS control card directly at the 
user’s terminal or batch job via the special system access 
feature described in Section 3.1. 

3.2.3.3.1 Control Card Call 
LIMITS. 

The LIMITS call is identical to the 0P=I option in MODVAL. 

See Section 3.2.3.1.a.3.2 for definition of response to 
this call. 

3.2.3.3.2 Error Messages 

» ERROR IN LIMITS ARGUMENTS.» 

Invalid control card arguments. This call has no arguments 
associated with it. 
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M.O DEFINITIONS 

SPECIAL SYSTEM JOB 

A job initiated by a user at his control point which gets special 
treatment by the system in that it executes with the benefits 
of file securityi memory security-i and access to resources and 
system functions without restrictions from individual user 
validations* 

TREE-STRUCTURE 

Ordered data which consists of primary entriesn each of which 
has an array of related secondary entriesn each of which has an 
array of related tertiary entriesn etc* until arriving at the 
data which provides the desired controls. {Example in Section 
3 * 5 * 1 * 1 * 1 ’ 


LEVELS 

The hierarchical relationship of data on a tree-structured file. 
LINKAGE 

Random address {pointers! joining together all records of 
similar data to enable processing to proceed from one record 
within a level to the next. 

SPECIAL SYSTEM FILES 

Files which contain data {normally priviledged information 
warranting secrecy! that is necessary in controlling various 
aspects of system activity. These files are maintained as 


AA 3777 


nitNnDmusA 



CONTROL DATA CORPORATION 


DIVISION 


DOCUMENT CLASS__55i_ PAGE NO.__ 

PRODUCT NAME_ KRONOS £•! _ 

PRODUCT MODEL NH EOaa^g.l _MACHINE fc»D00/C])C CYBER 7S x7 3-,m 

direct access permanent files under the system user index 
•C377777B>» Access to these files is achieved via the *SFI1* 

ASYF function-* Due to this method of accessi these files can 
only be accessed by special system jobs- 

DIRECTIVES 

The defined list of identifiers and associated data fields 
which serve as input commands to a processor to direct the 
processor in creating or updating a special system file- The 
identifier portion uniquely identifies the specific control 
field within the file to be set with the contents of the data 
field- 

ENTRY 

A group of input directives which pertain to a data item of 
a given level- 

CHAR6E NUMBER 

The primary entry on the PROFILO file which is the basic 
identifier used for accounting purposes- A charge number may 
be valid to use for many users and one user may be validated 
to use many charge numbers- Each charge number may have 
several associated project numbers defined for it- Cl-IQ 
alphanumeric characters-} 


♦ See the KRONOS 5-1 Internal Maintenance Specification for detail on 
this function- 
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PROJECT NUMBER 

The secondary entry on the PROFILO file which provides sub¬ 
charge accounting* -Cl-aD alphanumeric characters.J 

USER -COR ACCOUNT! NUMBER 

Refer to Interchangeable Device ERS for definition* 

USER INDEX 

Refer to Interchangeable Device ERS for definition* 

haster user 

The user number which has permission to inquire and update 
control values for a given charge number on the PROFILO file* 
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UPC - APPENDIX A 

List of manuals in which documentation may be affected: 

PROFILE 

BURN 

Chapter Si System Utility Control Cards Section 

Operator’s Guide 

Chapter 6i Utility Operationi Appendix Bt Operator Nessages 

Installation Handbook 

Chapter 3 t Something in conjunction with VALIDUS 

Instant KRONOS 

Control Card Chapter - System control card formats 

CHARGE 

KRONOS 5.D Time-Sharing User's Reference Nanual 
Page 7-5 Recovery 
Page M-S CHARGE Command 
Page 5-5 t b-3 to b-7 Log In Procedure 
Page T-l Disclaimer on Account Card 

KRONOS 5.D Batch User's Reference Nanual 
Page 5-5 CHARGE Control Card 
Page 3-7 JOB INITIATION AND VALIDATION 
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KRONOS g.Q Operator's Guide 

Page g-bi S-17 Disable Validation 

Page fl-7 *CCNR* - validation required user access bit 


DOCUMENT CLASS. 
PRODUCT NAME_ 


ERS 


KRONOS g.l 


PROJECT 

KRONOS g.O Batch User's Reference Manual 
Page S-bM Control Card 

KRONOS g.Q Operator's Guide 

Page 5-10 Utility Operation 


MODVAL 

KRONOS g.O Batch User's Reference Manual 
Page S-b3 Control Card 

KRONOS g.O Operator's Guide 

Page 5-1 thru 5-10 Utility Operation 
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UPC - APPENDIX B 


The following accounting dayfile messages are issued by ICJ when a 
job completes and by CHARGE on completion of the entry of valid 
charge and project numbers: 

1> 21J 25> 3b} 

* yy»mm.dd. hh-mm.ss.CPC xxxxxx.xxx SEC.* 

Accumulated CPU time for the job. 


I * yy.mm.dd. hh.mm.ss.ChC xxxxxx.xxx KUH.* 

Central memory usage expressed as kilo-word-hours. {Field 
length * time.} 

I * yy.mm.dd. hh.mm.ss. flSC xxxxxx.xxx KPR.* 

Hass storage usage expressed as kilo physical records transferred. 

I * yy.mm.dd. hh.mm.ss.HTC xxxxxx.xxx KPR.* 

Magnetic tape usage expressed as kilo physical records trans¬ 
ferred. 
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APPENDIX C 

PROFILE LIST OPTION EXAMPLES 


EXAMPLE 1. Full File List 

PROFILO FULL FILE LIST OF FULL FILE. PAGE 1 

CHARGE NUMBER MASTER USER 72/10/02. 00.2b.Sb. 

1. CHARGNULLl NULL 

2. CHAR6NULL2 

3. CHARGOOOl PROFILE 

CONTROLS FOR PROJECT NUMBER PNIO 


CREATE = 72/10/02. CP = bM 

MODDED = 72/10/02. AP = 0 

TI = 00.00.00. CT = bM 

TO = 00.00.00. AT = 0 

CONTROLS FOR PROJECT NUMBER PNll 
CREATE = 72/10/02. CP = bM 

MODDED = 72/10/02. AP = 0 

TI = 00.00.00. CT = bM 

TO = 00.00.00. AT = 0 

CONTROLS FOR PROJECT NUMBER PNIB 
CREATE = 72/10/02. CP = bM 

MODDED = 72/10/02. AP = 0 

TI = 17.00.00. CT = bM 

TO = 2M.00.00. AT = 0 


USER NUMBERS VALID TO USE PNIB 
USERl USERB 


CONTROLS FOR PROJECT NUMBER PROJECTNUMOOOl 


CREATE = 

72/10/02. 

CP = 

bM 

MODDED = 

72/10/02. 

AP = 

BOMB 

TI = 

Ofi.00.00. 

CT = 

200 

TO = 

17.00.00. 

AT = 

20000 


USER NUMBERS VALID TO USE PROJECTNUMOOOl 
ABCUSER USERA lB3MSb7 
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M. CHAR60002 PROFILE 


CONTROLS 

FOR PROJECT 

NUMBER PN20 


CREATE = 

72/10/02. 

CP = 


nOODEl) = 

72/10/02. 

AP = 

0 

TI = 

00.00.00. 

CT = 

m 

TO = 

00.00.00. 

AT = 

0 


CONTROLS 

FOR PROJECT 

NUMBER PN21 


CREATE = 

72/10/02. 

CP = 


nOOOEl) = 

72/10/02. 

AP = 

0 

TI = 

OL.MO.OO. 

CT = 


TO = 

07.0^.00. 

AT = 

0 
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EXAMPLE S» Full File Charge Number List 

PROFILO CHARGE NUMBER LIST OF FULL FILE. 
CHARGE NUMBER MASTER USER 


PAGE 1 
75/lO/OS. 00.37.11. 


1. CHARGNULLl 
3. CHARGNULL3 
3. CHARGOOOl 
M. CHARG0003 
S. CHARG0003 


NULL 

PROFILE 

PROFILE 

PROFILE 


EXAMPLE 3. Full File Project Number List 

PROFILO PROJECT NUMBER LIST OF FULL FILE. 
CHARGE NUMBER MASTER USER 


PAGE 1 
73/10/03. 00.37.01,. 


1. CHARGNULLl 
3. CHARGNULL3 
3. CHARGOOOl 


NULL 

PROFILE 


VALIDATED PROJECT NUMBERS ARE - 
PNIO PNll 

PN13 PROJECTNUMOOOl 


M. CHARG0003 


PROFILE 


VALIDA.TED PROJECT NUMBERS ARE - 
PN30 PN31 

PN33 PR0JECTNUM0003 


5. CHARG0003 


PROFILE 


VALIDATED PROJECT NUMBERS ARE - 
PR0JECTNUM0003 
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EXAMPLE Master User Full File List 
PROFILE •,0P=LiL0=FM 

PROFILO FULL FILE LIST OF MASTER USER PROFILE 


CHARGE NUMBER 


75/10/05. 00.3S.3fl. 


1. CHARGOOOl 


CONTROLS 

FOR PROJECT 

NUMBER PNIO 


CREATE = 

75/10/05. 

CP = 


MOODEO = 

75/10/05. 

AP = 

0 

TI = 

00.00.00 

CT = 


TO = 

00.00.00 

AT = 

0 


CONTROLS 

FOR PROJECT 

NUMBER PNll 


CREATE = 

75/10/05. 

CP = 


MOOOEO = 

75/10/05. 

AP = 

0 

TI = 

00.00.00. 

CT = 


TO = 

0 D *00•0 0 ■ 

AT = 

0 


CONTROLS FOR PROJECT 

NUMBER 

PN15 


CREATE = 75/10/05. 

CP = 



MOOOED = 75/10/05. 

AP = 


0 

TI = 17.00.00. 

CT = 



TO = 5M.00.00. 

AT = 


0 

USER NUMBERS VALID 
SERI USER5 

TO USE 

PN15 



CONTROLS 

FOR PROJECT 

NUMBER 

PROJECTNUMOOOl 

CREATE = 

75/10/05. 

CP = 


MODDED = 

75/10/05. 

AP = 

50M5 

TI = 

Oa.00.00. 

CT = 

500 

TO = 

17.00.00. 

AT = 

50000 

USER NUMBERS VALID TO USE 
ABCUSER USERA 153^Sb7 

PROJECTNUMOOOl 

CHARG0005 

CONTROLS 

FOR PROJECT 

NUMBER 

PN50 

CREATE = 

75/10/05. 

CP = 

m 

MODDED = 

75/10/05. 

AP = 

0 

TI = 

00.00.00. 

CT = 

m 

TO = 

0Da00«00« 

AT = 

0 


AA 3777 


PRtNTOINUSA. 



CONTROL DATA CORPORATION 


DIVISION 


DOCUMENT CLASS__ PAGE Kin V C-5 Rev A _| 

PRODUCT NAME_ KRONOS 5.1 __ 

PRODUCT MODEL NO_ £066*5■! _MACHINE <;prip<; taODO/CDC C YBER 75 t?3-.7M 


CONTROLS 

FOR PROJECT 

NUNBER PN51 


CREATE = 

7B/1D/D5. 

CP = 

bM 

NODDED = 

75/10/DB. 

AP = 

0 

TI = 

Ob.MO.00. 

CT = 

bM 

TO = 

07.0M.00. 

AT = 

0 
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EXAMPLE S. Master User Charge Number List 
/PROFILE ■,0P=LiL0=CM 

PROFILO CHARGE NUMBER LIST OF MASTER USER 
CHARGE NUMBER 

1. CHARGOOOl 

2. CHARGDDD2 

3. CHARG0DQ3 
LIST COMPLETE. 

/ 


EXAMPLE t. Master User Project Number List 
PROFILEnOP=L-.LO=PM 

PROFILO PROJECT NUMBER LIST OF MASTER USER PROFILE 

CHARGE NUMBER 72/10/02. OO.BM.IT. 

1. CHARGOOOl 

VALIDATED PROJECT NUMBERS ARE - 
PNIO PNll 

PN12 PROJECTNUMOOOl 

2. CHARG0002 

VALIDATED PROJECT NUMBERS ARE - 
PN20 PN21 

PN22 PR0JECTNUM0002 

3. CHARG0003 

VALIDATED PROJECT NUMBERS ARE - 
PR0JECTNUM0003 

LIST COMPLETE. 

/ . 


PROFILE 

72/10/02. 00.33.3a. 
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APPENDIX D 

DSD AND DIS COIHIANDS 
FOR USING TIMED/EVENT ROLLOUT 

A* In all DSD file displays the timed/event rollout files will be 
displayed as *TEFT5i= file types* In additiom the Q display has 
all *TEFT* rollout files flagged by 

B* The DSD commandT ROLLINiXX. may be used to roll in a TEFT job* 

C* For a job at control point ni the DSD command 
n.R0LL0UT-.XXXX. 

will roll the job out for XXXX seconds* 

D* The command to roll a job out for a time period may also be 
used under DIS as follows; 

ROLLOUTnXXXX. 

E* An additional CI1RDECIC entry is also provided which may be 

utilized to vary the length of the system event table used for 
timed/event processing* The default length of the table is b 
CM words* The format of the entry is: 

STL=xxxx* 

where 

XXXX = the desired length* 
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APPENDIX E 

DESCRIPTION OF SPECIAL ENTRY POINTS 

The following special entry points will be available in XRONOS 2-1 
for ABS SYSTEM PROGRAMS- The routines SYSEDIT and lAJ process these 


entry points- 


Entry Point 

Description 

ARG= 1 

Suppress argument passing- 

DMP= ! 

Dump previous job before load- 

RFL= i 

Automatic field length assignment. 

j 

RID= j 

Return files of specified ID on job termination. 

SDM= 

Suppress control card dayfile message. 

SSJ= 

Define job as special system job. 

VAtil= 

Reload job from specified file. 


ARC= 


Used for jobs that wish to do their own control card programs 
argument processing- Control card parameters are not passed 
to RA+ARGR if ARG= is present- 


DMP= 

Any job with DMP= > 0 causes the field length program and exchange 
package of the previous program job to be dumped to a file before 
loading the job with the DMP= entry point- When the DMP= program 
does an ENDn the field length and exchange package from the dump 
file are reloaded. If 0 < DMP= ^ 100B-. the full field length of 
the previous program will be dumped to the file- If DMP= > lOOBi 
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only the amount of field length specified by the value of I>I1P = 
will be dumped. In neither case will executing field length be 
reduced from that of the preceding program* 

RFL= 

When a program with an RfL= is loaded from the systemi the 
program’s field length is set to the value of RFL= -Grounded to 
the next higher IQOB wordsl. 

RID= 

Upon job completion of a program with RID® entry point-i all 
files with ID’S equal to the RID= value are returned before the 
next program is loaded. The range of values for RID® is one to 
seventy-seven octal. 
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Example: 


If the program contains ENTRY RID®i RID® E(3U 20B-. and SETID 


FILEt 20B then the file specified at FET address FILE will be 
automatically returned upon completion of the RID® program. 


spn® 

For programs with SDI1= entry pointsi no dayfile message is gener¬ 
ated on the control card call. The program should issue his own 
message. An example of the use of this is in PFILES. Many PFM 
control cards require the specification of a password that should 
not appear in the dayfile. (tihen ATTACH-iA/Pljl®KEY. is issued-i 
PFILES using the SDM® entry point can strip off the password and 
issue the dayfile message - ATTACH-iA/PU®*******. 
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SSJ= 

Programs with SSJ= entry points are defined as special system 
jobs. The address specified by the SSJ= entry point determines 
the start of a parameter area where the user accounting control 
words are temporarily stored to allow the special system job 
access beyond the user's validation. lilhen the special system 
job completes -Cor aborts! the user's validation parameters are 
retrieved from the parameter area within the special system job's 
field length and restored in the control point area. All local 
files created by the special system job are returned before 
normal control card processing is resumed. 

NOTE: 

Requirements for proper specification of special system jobs: 

1. An RFL= entry point must precede the SSJ= entry point to 
allow SYSEDIT to validate that the parameter area will 
fit within the special system job's field length. 

E. All programs that wish to run as special system jobs 
must be specified in LIBOECK or in SYSEDIT input. The 
following is the format of the entry in both cases: 

*SSJ NAni-iNAnB-.... iNAHN 

This allows programs NAMln NAflEi...-! and NAMN to run as 
special system jobs if they contain SSJ= entry points. 

3. The common deck COfISSSJ should be used to determine 

parameter area length and for any references to specific 
words within the parameter area. 
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If !!•> and 15•> are not presenti the SSJ= entry point will 
merely be added as another normal entry point for the program 
and no special system job processing will be done for that 
program. 


VAIil= 

Upon completion of a program with a VAIi)= entry point i the system 
will load the next program from the file specified at RA+CCDR. 
The reload file should be formatted exactly like the dump file 
created by use of ])f1P= entry points. The file format is: 

SYSTEM 

SECTOR 


RA 

RA + IDOB 

LENGTH 

SECTORS 


EOI 

SECTOR 


EXCHANGE 
PACKAGE SECTOR 
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The exchange package will be replaced from this file and program 
execution will start from the P address specified in the exchange 
package. 


Example: 

RESTART will use this entry point to begin execution for 
checkpointed programs. 
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1.0 SCOPE 

1.1 This specification provides the characteristics of the SMM 

support feature. The flMM can be used in any of the following 
manners: 

1. System Device 
S* Permanent File Device 
3. Shared Device 
Swapping Device 
S. Removable Pack 

b. Scratch Device {for local files! 
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2.0 APPLICABLE DOCUHENTS 

2.1 POD - KRONOS Version 2.1 

POD - flMM Disk Storage Subsystem/bDQ0/70DQ -CIOMfl^l.Q} 

ERS - 6MM Disk Storage Subsystem/bD0D/7Q00 -CIDMS^l.O} 

Programming Standard No. 1.67.0051 System Error Recovery for 
Rotating Mass Storage 

Proposed Standard for Engineering File content 
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3.0 DESCRIPTION 

3.1 Support of the 7QS4/SMM subsystem consists of a driver that 
will drive from one to eight fi44 units as one mass storage 
device. Also provided will be system modifications for 
handling any modules necessary for preloading the firmware 
into the buffer controller. 

3.5 The SM4 driver will be similar to all other mass storage 

drivers provided in the operating system- Addressing will 
be performed at a S:1 interlace. The addressing algorithm 
provides access to T3.fl percent of the device. The driver will 

I 

have a minimal transfer rate of 4S.0 thousand CM words per second 
and an average transfer rate of 44.0 thousand CM words per second. 
The average latency of the disk is fl.3 milli-seconds. Equip¬ 
ment type for the driver will be *DI* and the driver will be 
called ^bDI*. 

3 .5.1 System Error Messages 

DIxxi Nyyi STnnnni Un Cnnnn Tnn Snn- 

XX = Equipment number * 

yy = Number of times operation attempted 

STnnnn = Status 

Un = Unit 

Cnnnn = Cylinder 

Tnn = Track 

Snn = Sector 
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DXxxi ssssssssssssssssssssssss 
]>Ixxi ssssssssssssssssssssssss 
XX = Equipment number 
s - s = IMM bits of detail status 
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3.3 Routines involved with deadstarting the system will provide inter¬ 
pretation of CMR deck entries to properly define the flMM equipment 
in the running system. These routines will also handle the pre- 
loading of the firmware into the fl4^ Buffer Controller. -CThe 
firmware is loaded on all levels of deadstarting•>* 

3.4 In order to format -Cwrite headers on} an S44 packi one of the 

I two following methods must be used.** 

I 3.4.1 The following CflRDECK command extension is provided to allow 
formatting of a pack during deadstart. This method must be 
used if the pack is to be used as part of the running system. 

I INITlALIZE-,eq-,-.F. 

eq = EST ordinal of equipment containing pack to be formatted. 

3.4.2 To format a pack while the system is runningi option four {4} 
of H])I -Cflass Storage Device Initialization} must be exercised. 
{Refer to the Removable Device ERS for detailed explanation of 
this method.} 


* Any future modifications to the firmware will not be supported by 
the KRONOS development group. 

** The format of an entire pack requires a minimum of S minutes. 
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I 3«S The following table represents capabilities provided by the 
70SM/aMM subsystem and the level of support given to these: 


CAPABILITY 


1* 1:1 Interlace 

2. 2:1 Interlace 

3. Seek Overlap 
Write Verify 

S. Read Checkword 
Dual Access 

7. System function to Format Pack 
fl. Buffer Controller Firmware Load 

T. Support 1-6 packs as 1 device 

10. Error Correction -CREADl 

11. Additional Error Status 

{Provided thru Detailed Status} 
12* Address Field Correction 

S — Will Support 
N — Will Not Support 
13. Auto Dump of Buffer Controller 


LEVEL OF SUPPORT 


X 

X 

X 

X 

X 

X 

X 

X 

X 


X 


X 
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M.Q DEFINITIONS 

M-l Buffer Controller 

The processor that provides the guiding source of intelligence 
for the disk storage subsystem. The PPU software communicates 
with the subsystem software that is executed by the buffer 
controller when a disk I/O operation is desired. 

M.5 Disk Storage Subsystem ■C7DS^/fi^^} 

The hardware configuration consisting of a buffer controller! 

I MQTfci -Clla bit} words of memoryi the associated coupler to the 

higher level processor and the associated hardware which drives 
from one to eight CDC a^^ disk storage units. The coupler 
I connects an I/O data channel associated with a higher level 

processor. 

M.3 Driver 

This is a PPU program which can be called an an overlay to an 
executing PPU program. It contains the addressing algorithm 
necessary for converting logical disk addresses to physical 
disk addresses. It also issues the necessary external function 
codes for communicating with the buffer controller in order to 
perform I/O. The driver also contains routines to attempt any 
error recovery and to issue appropriate error messages to the 
system error log. 
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Firmware 

The software which must be preloaded into the buffer controller 
to drive the hardware and also to enable it to communicate with 
the higher level processor. 

2!l Interlace {Half-Tracking} 

The method of assigning successive logical addresses to separated 
physical addresses to allow the higher level processor to transfer 
the data to/from central memory and do any other required tasks 
before accessing the disk again without losing revolutions. 

H.b Latency 

The time required to locate the beginning of a particular 
storage location. Average latency is normally the time required 
to make one half revolution of the disk. 

Transfer Rate 

The amount of data that can be transferred from the disk to 
the PPU and on into central memory in a given amount of time. 
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6 ^^ ERS - APPENDIX A 

List of manual references requiring documentation changes or 
additions: 

INSTANT : 

Chapter 3 — Mass Storage Data Organization 
Chapter L — External Function Codes 

OPERATOR’S GUIDE : 

Chapter 1 — System Configuration 
Chapter 2 — Equipment Status -CE} Display 
Chapter S — Equipment Configuration Commands 
Appendix B — Operator Messages 

burn : 

7-7fi — Define Command 
5-11 — Assign Card 

INSTALLATION HANDBOOK : 

B-T — CMR Deck Entries 
2-lD - RTK Entry 
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APPENDIX B - ADDRESSING ALGORITHM 

TOSH/aMM-n MULTIPLE DISK DRIVE 

KRONOS accesses the 7QSM and n aMH's as a single device- 
n may range from one to eight. 

Equipment Type = DI 

Sectors/Track = 107 

Tracks/Device = Halt 

lilords/Device = lliObt-iBba^n 

Maximum Data Rate = Mb-IK words/sec- 

Address Mapping: 
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1.0 SCOPE 


1*1 This specification provides the external characteristics of 
the expanded features in KRONOS 2.1 associated with CYBER 
Hardware Support* 
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2*1 KRONOS Version 2«1 Product Objectives Document. 

V2.D Batch User's Reference Manual 
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V2.D KRONOS Instant 
V2.D Operator's Guide 
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3.0 DESCRIPTION 


PAGE NO. 


VII 


3 Rev A 


MACHINE «;PPiP^ bOOO/CDC CYBER 75.7 3.7H 


3.1 KRONOS S.l will make use of the CYBER distributive data path 
feature when available. The DDP will be used for data transfers 
between PPU's and ECS. The only external change involved with 
this will be the addition of two optional parameters on the EST 
entry for ECS. Alsoi it will be possible to enter the device 
type as "DP”. The format of the entry will be as follows: 

E(2xx= DE-i sti szi can cb. 

Ei3xx= DPi sti S2i ca-i cb. -Coptional form! 

Where: 

XX = Equipment Ordinal 
DE = ECS 

DP = Distributive Data Path 
st = Status CONt off or NA} 
sz = ECS words available/lOOQB 
The additional parameters ca and cb specify one or two DDP 
channels. When the DDP is available-i the driver in use will 
be called bDP and the device type in the EST will be "DP". 

3.2 ECS will be used for storage moves in KRONOS 2.1 whenever 
available. This will be done automatically if ECS is available. 
If an ECS parity error is encountered during storage move-i the 
following will take place: 
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!• Move will be completed with normal move code* 

2* All future movesi until the next deadstarti will be done 
without the use of ECS* 

3* The message *ECS OFF.* will be displayed at the system 
control point* 

The area in ECS reserved for moving is part of the label track 
for the device* 

3*3 The alternate devices library capability will provide the 
following capabilities: 

1* It will be possible to place copies of ABSi OVL and PP type 
routines on devices other than the system device-Csl* If an 
attempt is made to place any other program type on an alter¬ 
nate device! the message ^ILLEGAL CM/AD RESIDENCE-i MUST BE 
PPi OVLi OR ABS.* is written to output and the run aborted* 
2* Only one alternate device per routine will be allowed* 
lilhen the alternate device is specified for a routine-i 
this copy will always be usedi except in some cases of 
error recovery. 

3* An unrecoverable error on any alternate device for PPU 

routines will cause all accesses for loading of PPU routines 
to revert to the system device* An unrecoverable error in 
the case of a CPU routine will cause subsequent accesses 
from the system device for that routine only* 

M* The LIBDECK directives to SYSEDIT for selecting alternate 
devices will be as follows: 
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*A]>i ni tyl/reclityS/recSi..-tyn/recn 
where n is the equipment ordinal or the device type of the 
alternate device* The record type is specified as *ty» and 
*rec* is the record name* If the equipment does not existi 
the entry will be ignored with no error indication* Once 
routines have been placed on alternate devices t additional 
SYSEDIT's may delete the access to thesei but the space on 
the alternate device will not be released. 

5* An alternate system device is defined at deadstart -CCIIRDECK 
time> with the entry: 

ASR=]>3^-.Dg-.*.*-.]>^* 

I>£ is the alternate device equipment ordinal with the 
following restrictions: 
a* must be mass storage 
b* 0 ^ i ^ 2DB 
c* may not be system device 
d* may not be removable pack device* 
b* In the case of ECS being an alternate devicei all CPU routines 
residing there will be loaded directly by central monitor* 

This is accomplished by a new central monitor function *LCEri*. 

The major areas of use for this feature are: 

1* Place selected routines in ECS for very fast access* 

2* Placing PPU routines on perhaps an Smi for example-i where 
latency is better even though the system is on an fiOfi* 
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3*M The dual access capabilities of the fim and 831 will be supported 
by KRONOS 2«1« f8MM support of dual access is dependent on some 
hardware changes•> In order to utilize this featurei the dual 
access option in the hardware and dual 3SS3*s are needed. The 
EST entry for dual access is as follows: 

E(3xx= dti st-i en-I uni can cb. 

Itihere: 

XX = Equipment ordinal 

dt = Device type 

St = 0Ni OFF or NA 

en = Hardware equipment number 

un = Unit number 

ca = First channel 

cb = Second channel {cannot be 0} 

This is exactly the same as the standard EST entry currently 
except for the addition of a second channel parameter. 

An "R" parameter may be given as the last parameter on a mass 
storage EST entry. The second channel parameter on the EST entry 
for dual access forces the "R" option to be set whether or not 
it has been specified. If this parameter is seti then a release 
function will be performed any time a channel is dropped. The 
actual release is issued from *I1TR*. If this parameter is seti 
it is necessary that all equipment on the specified channel have 
the same release code. In the case of a 3SS3i this means that 
any other device connected to the channel must be capable of 
accepting a ”0" function. 
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M.O DEFINITIONS 

M-l Distributive Data Path 

The Distributive Data Path -CDDP} provides a new path of data 
flow between ECS and the rest of the system* The DDP consists 
of a MflD-bit buffer register attached to a channel. Options 
allow expanding a DDP to four registers. Each register connects 
to a standard input/output channel for maximum overlap of data 
transfer. This arrangement allows up to four PPU*s to transfer 
data to ECS at nearly the maximum data rate of the PPU*s. 

H.2 Label Track 

The label track t which resides on mass storage devicesi is used 
to preserve system tables and other necessary information that 
is dependent on the usage of the device. The label track may be 
used by the system and recovery to maintain status of information 
on the device or to recover the system. 

M-3 Dual Access 

Dual access provides two simultaneous data streams to mass 
storage units. The second access requires a separate controller 
and data channel* 

M.M Latency 

The time required to locate the beginning of a particular mass 
storage location. Average latency is normally the time required 
to make one half revolution of the disk. 
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l.D SCOPE 

1«1 This specification provides the characteristics for the KRONOS 
a«1/SCOPE 3.M Product Set Interface feature. 
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2.0 APPLICABLE DOCUMENTS 


2.1 SCOPE 3.M Reference Manual 
KRONOS 2.1 P.O.D. 

SCOPE 3.^ LOADER Reference Manual 

tOOD Record Manager Reference Manual -CbRMl 

COBOL M.O Reference Manual 

FORTRAN M.Q Extended Reference Manual 

SORT/MERGE 4.0 Reference Manual 

KRONOS 2*0 Batch User's Reference Manual 


AA 3777 


(■mNIEDMUSA. 



CONTROL DATA CORPORATION 


DIVISION 


DOCUMENT CLASS__ PAr^F Kin VUI 3 Rev A _ 

PRODUCT NAME_ KRONOS S.l _____ 

PRODUCT MODEL Kin EDfiS^a.l _MACHINE SERIES^QO^^^^^ 7aT73T?M 

3.0 DESCRIPTION 

KRONOS 2.1/SCOPE 3.M PRODUCT SET INTERFACE consists of interfaces 
to bRM and to the KRONOS loader -CLINK! from either the SCOPE 3.M 
Product Set or the Product Set user. The interface to bRM is via 
the program FILE and indirectly through the LDSET coiitrol card 
via the FILES option. The interface to the loader -CLINK! is 
through the LDSET control card and its associated directives and 
through the LDSET loader table generated by the SCOPE 3.M Product 
Set. 

The integration of the SCOPE 3. *4 product set also requires the 
integration of COMPASS 3.Di since the product sets make use of 
several new features offered by the new version of COMPASS. This 
necessitates additional modifications to the loader -CLINK! to re¬ 
cognize new XFILL and XLINK tables and to process the conditional 
relocation designator. 

3.1 The File program is called by the control card - FILE - and it 
allows the user to pre-store the File Information Table -CFIT! in 
the file ZZZZZDF from the information supplied on the control 
card. See bRM Reference Manual and bRM ERS. 

3.1.1 Format of control card* 

FILE-Clfn [r=axxxxxxxDCTkeyword=option3 ...! 

C3 denotes optional. 

* This control card is compatible with the same control card in SCOPE 

3.M. 
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Ifn - Name of FIT- 

axxxxxxx - Optional new name for FIT. Allows a file to be 
requested by a new name without assembly, 
keyword = option - Correspond to FILE macro parameters: they 

may appear in any order.** 


** Refer to bRfI Reference Manual Version 1.0 on the FILE control card. 
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3«1«B Example 

FILE{TAPEliFO=IS-,BT=C-,RT=F> 

Entries will be made in the file ZZZZZDF for the FIT TAPEl 
defining the file type as indexed sequential -CISIt the block 
type as character count -CO and the record type as fixed length 
{F>. 
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3»S The LDSET control card provides the user control of a variety of 
load operations. Options specified through LDSET apply for the 
current load only- A loader completion statement fname calli 
EXECUTEt or N0S0> terminates their effect. Each LDSET Control 
Card can be used to set several options or several LDSET Control 
Cards can be used. LDSET is legal in only the following types of 
load sequences: 

1. LDSET 
LOAD. 

EXECUTE. 

2. LDSET. 

LOAD. 

NOGO. 

3.8.1 Format of control card 

LDSET Coption^^ Toption^ i... Toption^^} 

Each option is specified in one of the following forms: 

Key 

Key = param 

Key = param^^/paramg/. . . ./param^ 

3.8.1.1 LIB = libname^^/libname^/..../libname^^ ~ optional 
libraries to be used in the following load. These libraries 
will follow those on the LOAD or LINK statement but will pre¬ 
cede both the alternate library specified by the LIBRARY 
statement and the particular default compiler library in the 
order of satisfying externals. Each use of LIB causes the 
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specified names to be added to the end of the set of libraries 
specified on the previous LIB. The entire set of libraries 
is processed sequentially and is not checked for duplicates. 

LIB with no parameters nullifies the effect of all previous 

LIB = libnamei/..../libname statements- 
Ji n 

3.2.1.2 MAP = p option 

This option directs generation of the load map- Sub parameters 
control the degree of the map produced. For specification of 
the p options reference the HAP statement specification in 
the KRONOS 2.0 BATCH USER'S REFERENCE MANUAL- 

3.2.1.3 PRESET = p option 

The preset option specifies the values to which unused core 
in the CM field length is set prior to execution of the loaded 
program. During the loading process•> the loader presets core 
including blank common-■ the same as a SETCORE followed by 
LOAD would be processed. After the loaded program has been 
relocated to its execution location in corei all core after 
the loaded program up to the execution field length specified 
on the job card is preset to the value - p -. The default 
value of PRESET is NONE. 
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E ^ 

NONE 
ZERO 
ONES 
INDEF 
INF 

NGINOEF 
NGINF 
ALTZERO 
ALTONES 

ERR = p option 

The ERR option selects one of three methods of handling load 
errors. If no ERR option is specified! the default value is 
FATAL. 

p = ALL Program is aborted for FATAL and NON FATAL errors. 

p = FATAL Program is aborted for FATAL errors only. 

p = NONE For this optioni the loading process continues 

if possible. If the completion statement is 
EXECUTE 1 normal program execution is initiated! 
including passing of execution parameters! field 
length adjustment! and core presetting. This is 
contingent upon a transfer address having been 
encountered prior to occurrence of the fatal 
error. If no transfer address has been encount¬ 
ered! the job is aborted. 

3.2.1.5 REUIND and NORElilIN option 

The REIilIND/NORElilIN options alter the default option for re¬ 
winding of the load file prior to loading. If these options 


Octal Value 
No presetting 
□OOQ OQDO 0000 0000 0000 
7777 7777 7777 7777 7777 
1777 0000 0000 0000 0000 
3777 0000 0000 0000 0000 
bOOO 0000 0000 OOOO 0000 
MOOO 0000 0000 0000 0000 
2 S 2 S aS 2 S 2ses 2525 2525 
5252 5252 5252 5252 5252 


CONTROL DATA CORPORATION 


DIVISION 


ERS _ 

KRONOS 2.1 
E0afl»2.1 


PAGE NO. 


VIII 7 


MACHINE SERIES 


bOOO/CDC CYBER 72!73!7M 


AA 3777 


PIWnCDINUSA. 



CONTROL DATA CORPORATION 

__DIVISION 

DOCUMENT CLASS__ PAGE NO.^11_S_ 

PRODUCT NAME_ KRONOS 5.1 _ 

PRODUCT MODEL NO_ E0fifl*a.l _MACHINE SERIES 

are not specified the default procedure is to rewind the load 
file except if the load file is defined as xiNPUT*. 

3*S»l«b USER = pnamej^/pnatneg/... ./pname^ 

The USER option causes the indicated program names {object 
modules! to be loaded regardless of whether or not they are 
needed to satisfy external references. If the loader is un¬ 
able to find an object module name in the libraries searchedi 
it flags a non-fatal error. 

3.2.1. ? USE = eptnamej^/eptname^/... ./eptname^ 

The USE option forces the loading of object modules to assure 
that specified entry points are included in the load. The 
loader loads the modules on the next occasion it satisfies 
externals. 

If the loader is unable to find an entry point name in the 
libraries searchedi it flags a non-fatal error. 

3.2.1. a FILES = Ifni/lfng/-/Ifn 

Ac n 

The FILES option is available to the Record Manager users to 
assure that the necessary bRM library programs for the pro¬ 
cessing of the specified files are loaded. Since the Record 
Manager processes four different file typesi the FILES option 
is used to avoid the excessive use of core by loading only 
those bRM programs that are needed for the file types of the 
files specified. Ifn is the logical file name and is also 


AA 3777 


PRIHIGDINUSA 



CONTROL DATA CORPORATION 

___DIVISION 

DOCUMENT CLASS_ ^ba^ia^ -■.^- PAGE _ 1 . - 

PRODUCT NAME_ KKONOS g.l _ 

PRODUCT MODEL NO_ £066*5.1 _MACHINE <;FpiF<; C YBER 75-.73174 

the symbolic address of the FIT for the file in the user's 
program. At load time the loader searches the first record 
of the file ZZZZZDF for a matching Ifn. In this record-i a 
maximum of b3 Ifn's are allowed at one word per entry. If 
the Ifn was defined in a FILE control card calli an entry 
for the Ifn will exist. 

The following records contain FIT information and entry points 
to bRH I/O routines. The relative location of an FIT record 
from record two corresponds to the relative location of its 
entry in the first record. When the proper FIT record is 
found the entry points to the bRM I/O routines are read 
starting from word 35 of the record and are added to the USE 
table {reference USE - 3.5.1.7>. 

The following shows the structure of the file ZZZZZOF: 
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C 




0 


HEAPER bJORP 


FILE ZZZZZPF 


RECORP 

1 


1 


Ifni 


ifnS 


UP TO L3 FIT NAMES 
{LOGICAL FILE NAMES} 




i 


bM 


RECORP 

2 


3S 


FIT INFORMATION 
FOR Ifni 


PUT.K 

{ 


i GET.F 

\ 


RECORP 5 CORRESPONPS TO 
Ifni 

1 ENTRY POINTS TO bRM ROUTINES 
r TO PROCESS Ifni 


RECORP 

3 


V. 


! IS.RM 


RECORP 3 CORRESPONPS TO 
IfnH 



I 


AA 3777 


mtNTB> IN U&A. 






CONTROL DATA CORPORATION 

--DIVISION 

DOCUMENT CLASS__ PAr,P Kin Rev ^ 1 

PRODUCT NAME_ KRONOS 5«1 _ _ 

PRODUCT MODEL Kin £066*5.1 _MACHINE cprip*; 7aT7 3i7M 

3.S.1.T SUBST = pair^/pair^/ .i/pair^ 

pair^ - Pair of entry point names in the form; 
eptn ame^^-eptn ame^ 

The SUBST option changes external references to entry point 
names to other entry point names* This feature can be used 
to cause loading of object modules other than those that 
would normally be loaded* 

As a result of SUBSTt a reference to external eptname^^ 
becomes a reference to external eptname^* See Example M* 

3*2*1*10 OMIT = eptnamej^/eptnameg/./eptname 

The OniT option directs that the specified entry point names 
are to remain unsatisfiedi regardless of whether or not the 
module containing these entry point names is loaded* The 
specified entry point names are processed the same as other 
unsatisfied names but do not result in errors* Some modules 
containing these entry point names may be loaded to satisfy 
other externals! but the specified entry points are not 
linked* 

An OMIT request takes effect from the time encountered until 
the end of load or until superseded by a USEt e*g*! OfllT-CXYZ} 
later followed by USE-CXYZl* See Example S* 
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3«5«S Examples: 

3*E«E*]i Example 1 

LIBRARY-CLIBl} 

LDSET-CLIB=LIBa/LIB3} 

LOAD-CBiLIBMl 

EXECUTE-CTESTl 

During load completion the libraries are searched in the 
following order. 

LIBM 

LIBa 

LIB3 

LIBl 

DEFAULT SYSTEM LIB 

3.a.a.a Example a 

LDSET{USE=ENTl/ENTa/ENT3} 

None of these entry points are necessary to satisfy externals. 

If PROGA contains entry point ENTl and PROGB contains entry 
points ENTa and ENT3 t then these two programs will be loaded 
on the following load sequence. PROGA and PROGB will be only 
loaded oncei if they are necessary to satisfy externals. Non- 
fatal errors will be generated if ENTln ENTa and/or ENT3 
cannot be found. 
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3*B.2»3 Example 3 

LDSET ■CFILES=TAPEl/TAPEa} 

TAPEl is an Indexed Sequential -CIS} file. TAPES is a Word 
Addressable {UA> file. If PROGA uses TAPEl and TAPEBi the 
following load sequence of PROGA will load the Record Manager 
routines that processes IS and lilA file types. 

3.a.B«M Example M 

LI>SET-CSUBST=I1EAT-BEANS/C0RN-RICE/PEAS-RICE} 

LGO. 

i 

I 

This sequence causes any references to MEAT to be treated as 

i 

references to BEANS and any references to either CORN or PEAS 
as references to RICE. 

! 

3.B.B.S Example 5 

LOADCFILEIJ 

LI>SET{OMIT=TAN} 

FILES. 

The linking of any external references to TAN is not inhibited 
during the loading of FILEl. Howeveri any references to TAN 
loaded subsequent to the OMIT request remain unsatisfied. 
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I 3.3 Binary Table Formats 

I 3.3.1 LDSET Table -CTODOJ 

Several compilers o'F the SCOPE 3.M Product Set generate an 
LDSET Table automatically with the other loader tables. The 
object directives of the LDSET table are equivalent to the 
options of the LDSET Control Card. 

The LDSET table follows the PIDL table and precedes all others 
in the loading sequence. 


The table format is as follows: 

ST Ma 3b D 



Each object directive begins withi or consists of a header 
word with the same general format as a table header word. 
The object directives-, and the names of the LDSET directive 
options to which they correspond are described below. Any 
all of them may be present in any order. 
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I 3.3.1.1 LIB •COOlOl 


FORM l: 



The above form clears the set of libraries specified from 
previous LPSET Control Cards. 


ST Ma 3b la 0 



The above library names will be added to those specified on 
the last previous LPSET Control Card. Libraries will be 
searched in the following orders 

1. Libraries specified on the LINK or LOAP statement. 

S. Libraries specified on LPSET statements. 

3. Libraries specified in LPSET table. 

M. Alternate library. 

S. Pefault system library. 
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I 3.3.1.2 HAP -CDOlll 

ST MS 3t. IT 

t is a map type octal codei with values and meanings as 
follows: 
t 

DO No map -CO or 0} 

01 Statistics and error messages -CS>* 

02 Above plus block names i addresses i and lengths -CBl* 

ON Above plus entry point names and values -CE}* 

10 Above plus external cross references -CX}* 

20 Above plus relative address references -CRl* 

I 3.3.1.3 PRESET -£0012} 

Preset specifies a value to be stored into each word of the 
core image that is not set by TEXT and REPL- 


la 0 



If p=Dt the value is used as is. Otherwise! the address of 
the location of each word-i to be preset-i is stored in its own 
lower la bits. See PRESETn Section 3.2.1.3. 

* Correspond to KRONOS MAP options as specified in the KRONOS 2.0 Batch 
User's Reference Manual. 
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I 3.3.1.M ERR -C0013> 

ERR specifies the severity that causes the loader to abort. 

ST Mfl 3b la D 


£ 

D 

1 
3 

I 3.3.1.5 REUIND/NOREUIN -COOim 

REtillND/NOREUlN specifies the default initial position for 
all files to be read by the loader. This table directive 
corresponds to the LDSET option for REUIND/NOREUIN. See 
Section 3.5.1.S. 


ST MB 3b la 0 






Dom 

DODO 

//y//: //, , / , ' -7-7'^ 

/. / /', /■ ' ■' '///// 
//'■-' ’ / ,•' ■ '■’V/ 

a:. :.jL^ j 

P 


£ Position 

D REliIIND 

1 NOREUIN 


0013 

0000 

'/ /i' / ///.J./'/ij .'V ///./// 

P 


Severity 

ALL 

FATAL 

NONE 
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I 3.3.1.b USER -CaOlS} 

USER supplies program names to be loaded even if their entry 
point names are not needed to satisfy external references* 


ST Mfl 3b Ifl D 



I 3.3.1.7 USE -COOlbl 

USE supplies entry point names to be treated as external 
references to be satisfied by entry point definitions! even 
if they are not referenced by a LINK loader table. 


ST Ma 3b la 0 
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I 3.3.1.6 SUBST -cool?! 


SUBST supplies entry point names to be used in place of 
external names appearing in all subsequent LINK tables. 



Each substitution descriptor is two words with the following 
format. 


external name referenced 


.... 1 

entry point name to be used instead 



I 3.3.1.^ OMIT {0020} 

OniT supplies names to be equated to *+M00000n'' where * is 

u 

the location of the word containing the reference! when they 
occur as follows: in previous LINK loader tables if they 
have not been defined by ENTR loader tables-i and uncondition- 
ally in all subsequent LINK loader tables. 
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3.3.2 XFILL Table -CMIOO} 

The XFILL table serves the same purpose as the FILL tablei but 
with most of the restrictions eliminated. The table format is 
as follows: 


ST Mfl 3b 21 12 DO 



cr Conditional relocation designator: The XFILL table is 
ignored if cr refers to a common block that was first 
declared by an earlier subprogram. 

Each relocation descriptor is one bO-bit word and specifies the 
relocation of one address field in a previously-loaded text 
word. The relocation descriptor format is as follows: 
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ST SM 30 5M 15 OT 00 


7Z^////////y 







a 

pos 

size 

br 

r 


a Relative address of text wordi may be as large as 

7777777g 

pos Bit position of the low-order bit of the address field 

in the text word 

size Address field length in bits 

br Base address designator for relocation quantity 

r Relocation base designator for text word addressi R 

cannot be 2 -Cnegative program relocation} and cannot 
refer to a blank common block 


The relocation quantity is determined from BR as follows: 
br relocation quantity 


000 

001 

Q02 

003 

DOM 


0 

P 

-P 

^2 


777g 


^ 50=1 


p Origin of the subprogram CM/SCM local block 

th 

Origin o^F the i common block listed in the subprogram 
PIDL table 
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The relocation quantity is added to the content of the address 
field in bit positions {pos+size-ll through -Cposl in the 
previously loaded text word whose location is given by r and a- x 

In doing the addition! the relocation quantity is lengthened 
to bO bits by sign extension and then shortened to the length 
of the field to be modified by simple truncation of the bits 
at the left end. The relocation quantity is then added to the 
field to be modified as if in a register of the same length as 
the field to be modified! with end-around carryi i.e.! the 
addend and augend are treated as having a sign bit and -Csize-l} 
magnitude bits. Since address fields cannot cross word 
boundaries! the following restrictions must be satisfied: 

□ f pos £ ST 

1 ^ size ^ bO 

1 f pos + size ^ bD 

3.3.3 XLINK Table {MSQQ} 

The XLINK table serves the same purpose as the LINK table! but 
with most of the restrictions eliminated. The table format is 
as follows: 
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PRODUCT NAME.. _ 

KRONOS 

2.1 





PRODUCT MODEL NO_ 

Eoaa*5. 

1 


. MACHINE «:pRIFS 

CYBER 

72-.73-,?M 

ST 

Ma 

3h 

27 

12 00 





cr Same as in the XFILL Table {3.3.H}. 


Each linkage sequence is one or more words with the following 
format: 


ST la 00 



The all-zero word terminating the linkage sequence may be 
omitted for the last for only} linkage sequence in the XLINK 
table. The first character of the external name may be any 
character code except SSg -Cblank} or 00 {colon}. 

Each linkage descriptor is one word with the following format: 
ST SM 30 SM la OT 00 

^ size hr p ^ 

ai POST sizeT r Same as in the XFILL table 
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The value of the external namei defined by an ENTR table in 
some other subprogram-! is added to the content of an address 
field in a previously-loaded text word. In doing the additioni 
the relocation quantity isi in effect-! lengthened to bO bits 
by sign extension and then shortened to the length of the 
field to be modified by simple truncation of the bits at the 
left end. The relocation quantity is then added to the field 
to be modified as if in a register the same length as that 
field-! with end-around carryi i.e.-! the addend and the augend 
are treated as having a sign bit and -Csize - 1} magnitude bits. 

3.3.M ACPfl -CS3Q0> 

The A CPU table contains the absolute dl/SCM image of a central 
processor program or overlay with one unnamed entry point or 
one or more named entry points. It may also contain an absolute 
ECS/LCM image. The ACPM table may have either of two formats: 
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Ig Must be zeros at present 

■fwas Address of the word in CM/SCM into which the table 

header word is to be loaded. For Format the 
first CM/SCM text word is loaded at address fwas 
+ 1. For Format the first entry point definition 
is loaded at address fwas + In and the first CM/SCM 
text word at fwas + k + 1. 

entry Address at which execution of the program or overlay 

is to begin 

k Number of entry point definitions! the complement 

of k is stored in the table to distinguish Format 
S from Format 1. 

entry point Same as in the ABS table 

definitions 

fwal* Address of the word in ECS/LCM to which the first 

ECS/LCM text word -Cif any> is to be loaded 

wcl* Number of ECS/LCM text wordsi may be zero. 

endl* Greatest addressn plus onen of the fixed ECS/LCM 

area used by this program^ if endl = Dn endl = 
origin 1 + wcl is assumed. 

wcs Number of CM/SCM text wordsi if wcs = On the CM/SCM 

text words comprise all that remains of the ACPM 
tablen which is terminated by an end of section 
{short PRU or U flag record}. 

^ Under KRONOS 2-1 the overlay loader LDR will skip these fields. The 
LINK loader will default these fields to zero during overlay genera¬ 
tion* Alsoi the S3DQ tsble is only generated for a level Dt D overlay. 
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ends and endl are the origins of the CM/SCII and ECS/LCM areas 
that may be used for dynamic storage allocation- ends must 
not be less than fwas + k + wcs and must not exceed the CM/SCfl 
field length at execution time. Similarlyn endl must not be 
less than fwal + wcl and must not exceed the ECS/LCd field 
length at execution time. 
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3.M SCOPE Function Processor CSFPJ 

SFP is a Peripheral Processor program consisting of those PPU 
functions utilized by the SCOPE 3.*4 Product Set for which there 
are no corresponding functions in KRONOS 2.I. SFP will be 
called by the PP loader routine in the PP resident whenever it 
is unable to locate and load a requested program. SFP will 
compare the name of the requested program against a table of 
valid names/functions. If a match is madei SFP will load and 
execute the requested program. If noti SFP will abort with the 
proper dayfile error message. The valid functions accepted by 
SFP are discussed separately in the following sections. 


3.N.1 STATUS Function -CSTSl 

The STS function returns to the caller information about 
system resources. Two types of information are returned in 
SCOPE 3.M format according to the function flag upon entry. 
The call to STS is as shown: 

ST MO 3t3S EM23 1617 


STS 


FUNCTION 


ADDR OF HEADER 


R = AUTO RECALLt must be set. 

Function = 1 - map available space on all public rotating 
mass storage devices. 

= 2 - return system information concerning files 
assigned to user program. 

ADDR OF HEADER = Address of header for return information. 
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Format of the header 

word must be: 



ST m 

3S 23 

11 

0 


word T 
be 

length return = Number of status words returnedi set by 

KRONOS when list is complete 

a = a must be set to 0 before issuing a STATUS call 

The header word is also the auto recall reply word: when bit 

"a" becomes In the request is complete. 

When Function = one word of information is returned for 
each public rotating mass storage device available. Format 
is: 

ST N7 3S a3 17 11 0 


0 

Status 

_i 

Device 

Type 

EST 

Ordinal 

Chan 

Eq 

Available 

PRO’S 


Zeros 

List Length 

Length 

Return 

{Reserved! 


Zeros 


list length = Number of wordsi excluding this header 
to be used for return information! must 
set by user to other than 0 


status = T bit binary field: 

ODD - Not available! off! not in use 

DMD - Unloaded pack 

120 - KRONOS System Routines 

mo - KRONOS System Routines on Pack 

b20 - Contains Permanent Files 

mo - Pack with Permanent Files 

700 - KRONOS System and Permanent Files 

7M0 - KRONOS System and Permanent Files on Pack 

device type = Hardware mnemonic in SCOPE 3.M display code: 


AA 

bb03 disk 

AB 

t>b3B disk 

AC 

bt03-II disk 

AD 

fits drum 

AF 

ai4 disk file 
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AL flEl multiple disk drive 

AN fim disk file 

AP 6SM disk drive 

EST ordinal = Position of entry for device in equipment 
status table IlE-bit binary field! 

chan = Channel number by which device can be accessed 

eq = Equipment -Ccontroller! number to which device is 
connected 

PRU's = Number of PRU’si divided by IDD octaln of space 
remaining on the devicei value of 7777 indicates 
at least EbEilDO PRU's available 


When Function = St the user places t before the calli a list 
of file names -Cleft justified! zero filled! in every third 
word of the list area. If the file existsi the file name will 
be replaced by a three word SCOPE 3.<4 format entry from the 
file name table {FNT!* If the file does not exist-i the file 
name will be zeroed out. The format of the SCOPE 3. *4 FNT 


entry passed to the user is: 

51 SM M7 35 E3 171b 11 0 


FILE NANE ^ CONTROL 

rXLC IMAIIL ^ POINT 

ZERO 


FIRST TRACK 

CURRENT 

TRACK 

ZERO 

CURRENT 

SECTOR 

ZERO 

- - - 

ZERO 

ID CODE 

PERNANENT 

FILE 

PERNISSIONS 

CODE AND 
STATUS 
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3»M»S SDA/SIS Message Generator Function {MSI>> 

Returns a message to a user's area associated with a message 
code passed by the user- The call to MSD is as follows: 

ST 35 17 0 


MSD 


MESSAGE CODE 


RETURN ADDRESS 


MESSAGE CODE = Number associated with message to be 
returned 

RETURN ADDRESS = Address to return message to beginning 

at Return Address + 1. 

Upon completion of the message transfer! MSD will return at 
Return Address the following: 


ST M7 35 23 0 


MESSAGE 

MESSAGE 

MESSAGE 



■1 

CODE 

SIZE-1 

SIZE 



Jb 


3.M.3 ALTER FILE Function -CPFEJ 

PFE alters the requested file to have an EOI recorded at the 
current position of the file. PFE allows support of the SCOPE 
3.M ALTER macro in the SCOPE 3.M product set. Format of the 
call to PFE is: 


ST 


17 


0 


PFEP 


FDB Addres 


s 


The parameter word set up by the user at the FDB address has 
the format: 


ST 


17 a S ID 


FILE NAME 


RETURN 

CODE 
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RETURN CODE = Uhen the *RT* parameter is defined in the 
ALTER macro call {SCOPE 3.M System Pro¬ 
grammer’s Guide }1 the following codes will 
be returned. 

ODD - function successful 

003 - unknown LFN 

055 - file unavailable 

0 = The following options are available to the user: 

Bit a - No recall {illegal in KRONOS 5.1} 

Bit 7 - not used 

Bit t - Return code to user 

F = Function code for alter. Bits 5-5 = 0111. 

C = Completion bit. Set when function is complete. 

3.M.M ADVANCE/BACKSPACE Control Card Function {ACE} 

Provides the SCOPE 3.^ compatibility for reading/backspacing 
a control card. This function is provided to ensure the SCOPE 
3.M product set compatibility. ACE reads/backspaces next/ 
previous control card into RA + 70B - RA + 77B with the option 
to place the control card in the dayfile and/or the crack and 
store the control card parameters in SCOPE 3.M or KRONOS 5.1 
format and place in RA + 5 - RA + 53B. Format of the call to 
ACE is: 

5T 35 5b 53 17 0 


ACEP 


0 

'TTTTTZ^/y 

FUNCTION ADDRESS 


0 = Option available 

XOl - Crack parameters in KRONOS 5.1 format 
XIQ - Crack parameters in SCOPE 3.M format 
IXX - Issue control card to dayfile 

FUNCTION ADDRESS = Address containing the function for 

ACE to perform. The format is: 
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S'? 


11 □ 


FUNCTION 


FUNCTION = 0100 - Read next control card 

= OOMO - Backspace to previous control card 

Whenever the function is completed! the completion bit 

■Cbit 0} is set. 


If a read function is issued and the pointer is at the end 
of the control card recordi an EOR status -CBit M set in the 
function code! is returned and RA + 70B - RA + 77B is cleared. 
If a backspace function is issued and the pointer is at the 
beginning of the control card record t the pointer is not 
changed and an EOR status is returned. 


3.M.S PERHISSION Checking Function {PRi1> 

Provides SCOPE 3.M product compatibility to allow the 
checking of file permissions. PRM will check for a file andi 
if found! will map the KRONOS S.l permission flags into SCOPE 
3.M permission bits and return the information to the user. 
Format of the call to PRM is: 


5 ^ 


35 


17 


Q 


PRM 



PARAMETER 

ADDRESS 


PARAMETER ADDRESS = Address containing the file to search 

for and to return information to. 
Format of the parameter is: 
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CODE 


FILE NAME 


CODE = A S-bit code returned to the user defining the 

permissions associated with the file. The right¬ 
most M bits are the permission bits with the 
following octal codes: 

01 - Read 
05 - Extend 
DM - Modify 
ID - Control 

The leftmost bit is the permanent file bit. If setn 
the file is a direct access or indirect access with 
controls. If not seti the file is either an in¬ 
direct file without control or a non-permanent file. 

Any file whose KRONOS 5-1 URITE LOCKOUT and/or 
EXECUTE ONLY bits are seti will return a READ only 
permission to the user. 

C = Completion bit. Set when function is completed. 


3-M.b Error Messages 

The error messages can be broken down into those messages 
issued by the main routine of SFP and those issued by each of 
the functions contained in SFP. 


B.M.b.l SFP Main Routine Error Messages 

»XXX NOT IN PP LIB.» - PP package XXX not in PP library. 
»XXX NOT IN PP LIB - CALLED BY XXX.* - PP package XXX not 
in PP library and was called by program YYY. 

*SFP ILLEGAL CALL.* - SFP was called directly. 

»SFP/XXX PARAMETER ERROR.* - Parameter address contained 
in the call to SFP function XXX was out-of-bounds. 
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*SFP/XXX ILLEGAL FUNCTION-* - Function number contained in 
the call to SFP function XXX was undefined. 

*SFP/XXX NO AUTO RECALL-* - Required auto-recall parameter 
not set on call to SFP function XXX. 

STATUS Function fSTS> 

None. 

3. M.ti.3 SDA/SIS dessage Generator Function {dSDl 
None. 

3.M.b.M ALTER File Function -CPFEl 

^SFP/PFE ILLEGAL ALTER FUNCTION.* - A function code other 
than the ALTER function contained in call to PFE. 

3.M.b.S ADVANCE/BACKSPACE Control Card Function -CACE} 

*SFP/ACE FUNCTION CODE UNDEFINED.* - Function code in call 
to ACE was not a READ or BACKSPACE. 

3.4.t..b PERMISSION Checking Function -CPRfl} 

None. 


AA 3777 


PfUNTQ} IN USA. 



CONTROL DATA CORPORATION 

-DIVISION 

DOCUMENT CLASS__ PAr,F Nin I 

PRODUCT NAME_ KRONOS 5-1 _ _ 

PRODUCT MOOEL Kin . EDfifl^g.l <:.ppiP^ (3dOD/Ci>C CVSLR ^ 

3.S PROGRAM RECOVERY 

The program recovery capability of SCOPE 3. *4 is under KRONOS 2-1 
to provide support of the SCOPE 3»M products under KRONOS 2-1 
through the use of the RECOVR macro contained in the SCOPE 
ACTCOM carried under KRONOS 2.I. 

3.S.1 RECOVR Function 

The RECOVR macro allows a user program to gain control at the 
time that normal or abnormal job termination procedures would 
otherwise occur. Initialization of RECOVR at the beginning of 
a program establishes the conditions under which control is to 
be regained and specifies the address of user recovery code. 

If the stated condition occurs during program executiom control 
returns to the user code. RECOVR macro expansion calls the 
SETUP, subroutine. 

RECOVR is concerned with conditions that affect job execution. 

The conditions under which KRONOS will return control to the 
useri and the octal values that will select them in the call 
to RECOVRt are: 


Arithmetic mode error 

QQl 

PP call error 

□02 

Time limit 

DOM 

Operator drop 

010 

System abort 

□20 

CP abort 

OMO 

Normal termination 

100 
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Conditions can be combined as desiredn with octal values up to 
177 allowed in the flag field of the call to RECOVR- 


At least five seconds of central processor time always will be 
available for user code execution* RECOVR makes the exchange 
jump package and RA + 1 contents available to the program if 
user recovery code is executedi and gives the user the option 
of having normal or abnormal job termination output* 

Initialization of RECOVR within code at the beginning of a 
program results in an entry in a stack of requests for PP 
program RPV. Only one set of recovery conditions can exist 
within RPVi but RECOVR allows up to five user and system sets 
of flags and code for each program* The last RECOVR initial¬ 
ization will receive control first* 

A checksum of the user recovery code can be requested during 
initialization* If flagged conditions subsequently occuri 
RECOVR will again checksum the code before returning control 
to it* This gives some assurance of user code integrity 
before it is executed* 

RECOVR is initialized from a COMPASS program with: 

RECOVR name iflagsichecksum 

name Address of code to be executed if flagged 

conditions occuri a return jump will be made 
to this location 

flags Octal value for conditions under which recovery 

code is to be executedi as outlined abovei 
default is 7? 
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checksum Last word address of recovery code to be 
checksummedi 0 if no checksum 

If one of the flagged conditions occursi the address of the 
exchange Jump package will be in register 61 and the RA address 
in 63. Register A1 will contain the address of the list of 
the parameters passed in 61-63. Register 65 will contain a Di 
if the recovery code sets 65 to a non-zero valuei or if the 
code contains an ENPRUN macro or an RA + 1 request for ENPi 
normal job termination procedures will follow. Otherwise! 
abnormal job termination procedures will follow recovery code 
execution. 

If a program calling RECOVR contains overlays! both the call 
to RECOVR and the user recovery code should be a part of the 
level □!0 code. 

The exchange jump package returned by RECOVR is in the format 
shown with the Pump discussion! with the system error code 
that caused recovery code execution in bits 0-17 of the first 
word. If the P register shows zero in the package because a 
mode error occurred! bits 31-^7 of RA + 0 will contain the P 
register value. System error codes that may be returned are: 


Normal termination 0 
Requested time limit exceeded 1 
Arithmetic mode error 2 
PPU abort 3 
CPU abort 14 
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PP call error S 
Operator dropped job b 
Program stop 7 
File limit 10 
Track limit 11 
Mag tape limit IS 
System abort 13 


Both the FORTRAN and FORTRAN Extended languages contain 
RECOVR subroutines as detailed in their respective manuals. 


3.S.5 RPV Function 

RPV is the PPU portion of the RECOVR CP/PP package and is 
contained as a function in the PP program SFP. RPV should 
never be called directlyi but utilize the CP portion for all 
program recovery work. 


3.5.3 RECOVR Error Messages 

=*:REC0VR - TOO MANY RECOVERY REQUESTS.» - More than 5 recovery 
initializations occurred without a recovery being processed. 
*REC0VR - BAD CHECKSUM.* - The post-recovery checksum of users 
recovery routine does not equal the pre-recovery checksum. 
*REC0VR - BAD ARGUMENT LIST.* - Illegal parameters in pre¬ 
recovery initialization call. 
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3.S«M RPV Error Messages 

*SFP/RPV INITIALIZATION ERROR.* - If entry to RPV initialization 
without the Error Exit Return Address set. 

*REPRIEVE ABORTED BAD CHECKSUM.* - Post-recovery checksum of 
RECOVR routine does not match pre-recovery checksum. 

♦REPRIEVE ABORTED-VALIDATION TL.* - Current time limit +S 
seconds exceeds time that user has been validated for. 

♦JOB REPRIEVED.* - The job has been successfully reprieved. 
♦REPRIEVE ABORTED SYSTEM ERROR.* - Error condition unknown to 
RPV. 

♦REPRIEVE ROUTINE NOT IN PL.* - The RECOVR CP routine not in 
users field length. 

♦SFP/RPV CANNOT RESTORE PREVIOUS ERROR.* - RPV cannot restore 
the error that caused the initial termination. 

♦•CPREVIOUS ERROR CONDITION RESET.>♦ - RPV has restored the error 
condition that caused the termination. 
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3.t Error Statuses 

B.b.l LDSET Errors: 

1. *CANN0T PROCESS FILES REQUEST - 1ST RECORD OF ZZZZZDF TO 
BIG • ^ 

S. ^CANNOT PROCESS FILES REQUEST - ZZZZZDB TOO SHORT.* 

3. *LDSET CONTROL CARD ERROR.* 

4. *ERR0R IN LDSET OPTION.* 

5. *N0 TERMINATOR ON LDSET STATEMENT.* 

3«b.2 For errors related to the bRM FILE statement! see bDOO/TODO 
Record Manager Reference Manualn Version 1.0. 
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4.0 DEFINITIONS 

Unsatisfied External 

An external reference for which the loader has not yet loaded a 
module containing the matching entry point. 

Transfer Symbol 

Name of the entry point that specifies where execution is to 
begin. 

Program Name 

Also referred to as ident name or deck namei it is the name con¬ 
tained in the loader PRFX table at the beginning of each module. 

A program name is 1-7 characters^ colons are illegal. 

Object Nodule 

Often referred to as a relocatable subprogramn this is the basic 
program unit produced by a compiler or assembler. COMPASS norm¬ 
ally produces an object module from source statements delineated 
by IDENT and END. In FORTRAN-i the corresponding beginning state¬ 
ments are PROCRAMi SUBROUTINE-, BLOCK DATA-, or FUNCTION. The 
corresponding end statement is END. 

An object module consists of several loader tables that define 
blocks-, their contents-, and address relocation information. 

Core Image 

Also referred to as the loaded program or an absolute program-, 
this is the final image produced by the load operation. For a 
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control-statement-initiated loadi the core image is the entire 
job field length from RA{S> + lOOg through RA-CSJ + field length 
- 1 . 

For a user-call-initiated load operatiom the core image occupies 
only that portion of the field length specified by the user as 
being available. 

Core Image Module 

Often referred to as an overlay. It can be saved on a file for 
subsequent reloading and execution. 

Program Block 

The block within an object module that usually contains execut¬ 
able code. It is automatically declared for each object module 
■Cthough it may be zero-length}. It is local to the modulei that 
isi it can be accessed from other modules only through use of 
external symbols. Data placed in a program block always comes 
from its own object module. 

Entry Point 

A location within a block that can be referenced from object 
modules that do not declare the block. Each entry point has a 
unique name associated with it. The loader is given a list of 
entry points in a loader table. A block can contain any number 
of entry points. 
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The loader accepts an entry point name that is 1 to 7 charactersi 
colons are illegal* 


Some language processors may produce entry point names under 
more restricted formats due to their own requirements. 


External Reference 

A reference in one object module to an entry point in a block not 
declared by that module. Throughout the loading processi externals 
are matched to entry points -Cthis is also referred to as satisfy¬ 
ing externals}! that isi addresses referencing externals are 
supplied with the correct address. In some casesi for SCOPE 3.M-» 
this process is inhibited -Ce.g. t OMIT request}! the external 
reference then remains unsatisfied. 


Library File 


A collection of core image modules and/or object modules that 


can be accessed by the loader through a directory. For library 
generation! see the KRONOS 5*0 Batch User's Reference Manual. 
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l.D SCOPE 


1*1 This specification provides the characteristics of a text 


editor for time-sharing users. 


"%*■ 
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B.D APPLICABLE DOCUMENTS 


B»1 KRONOS Version 5»1 Product Objectives Document. 
V2.D Batch User's Reference Manual 
VB.Q Time-Sharing User's Manual 
V2.0 Edit Reference Manual 
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3.0 DESCRIPTION 

Text Editor allows the time-sharing user to edit a data file. 
The data file being manipulated is a single record filei herein 
referred to as the text or edit file. During editingi the 
search pointer identifies the line of the text file to be 
examined first. The search-pointer can be moved forward and 
backward to specify a new line. 


3*1 Editing operations are broken down into three categoriesi line 
commands! string commands and auxiliary commands. The basic 
structure of a command is: 

COMMAND:/phrase/in 

A /phrase/ is the command component which specifies a character 
string of interest.♦ It may be of a simple form /pl/i or complex 
/pl/t/pB/. One restriction is that /pi/ and /p2/ must each be 
contained in a single linen though not necessarily the same line. 

The command component ”n" is a specifier which indicates the 
number of lines the command will affect or the number of times 
the command will act on the presence of /phrase/.* 

The specifier is generally an unsigned integer constant. If 
omitted-! unity is assumed. If n=*-i the specifier is set to 
131000 which implies all or in some cases last. 


* Certain AUXILIARY commands deviate from these definitions. 
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The editor communicates with the user in command and text modes. 
Certain commands require the user to make text available which 
will be added or substituted in the edit file. This is accom¬ 
plished by posting a request to ENTER TEXT. 

The user responds by typing in a pre-delimiteri followed by a 
stream of new text and post-delimiter. Uhen post-delimiter is 
encountered! editor replies with READY. Data is copied 
to a scratch file named SCR. The user may access data already 
written to SCR by hitting carriage return CCR} only. If the 
contents of the string buffer Cscratch file SCR5> are desired 
as replacement texti the user types in followed by CR. 

Other commands obtain replacement text from the complex form of 
/phrase/! wherein /p5/ is used. 


The editing package described herein contains a number of ne<»< 
commands which have no counterpart in the KRONOS B.Q editor. 

The format of these new commands is detailed following the 
description of the individual command. Additional information 
on other commands may be found in the V2.D Edit Reference Manual 
■Cdocument ST1S07QD Rev. B} on the page number noted. 

3.1.1 Line Commands 

A line command is one whose basic unit of operation is the 
line. That isn any execution of a line command causes an 
entire line to be affected. An abbreviated form of the 
command word is noted in parenthesis. 
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The search-pointer is unaltered for all line commands except 
FIND* The FIND command will cause the search-pointer to 
remain set at its newly found position- All commands are 
executed for one or more lines depending on the specifier t 
represented by n in the discussion of individual commands 
which follows. 

B-l-l-l ADD -CAl Page 5-fl 

One or more lines of text are to be added to the edit file- 
The one or more lines are entered as described above in 
response to the editor request ENTER TEXT- The new text is 
added after the nth line or after each of the first n lines 
containing /pi/. 

3-1-1-E BLANK "CBl Page 2—10 

One or more lines of text in the edit file are replaced by 
blank lines- Lines blanked are the first n lines or the 
first n lines containing /phrase/. If /phrase/ extends 
over more than one line-i all lines associated with /phrase/ 
will be blanked. 

3.1.1.3 CHANCE -CO Page 2-t. 

One or more lines of text in the edit file are deleted and 
replaced by text entered in response to the editor request 
ENTER TEXT- If /phrase/ extends over more than one linei 
all lines associated with /phrase/ will be deleted and 
replaced by the text entered. Note that the replacement 
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text may be morei less or equal to the text deleted. 

3.1.1. H DELETE -CD! Page 5-T 

I One or more lines from the edit file are to be deleted. All 

lines of a multi-line /phrase/ will be deleted. If a line 
is deleted at which the search-pointer is setn the search- 
pointer moves to the next remaining line closer to the upper 
bound. 

3.1.1.S EXTRACT {E} 

j This command causes one or more lines from the edit file to 

be copied to the string buffer {Scratch File SCRSl following 
j the last entry to the buffer. The edit file is unaltered. 

I'P n lines containing /phrase/ cannot be foundi the copy is 
not performed. Valid forms of the command are: 

EXTRACTnn 

I Transfers n lines from the edit file to the string buffer. 

The copy begins at the current value of the search-pointer. 

{If n=*n all lines to the end of file are transferred.3- 

EXTRACT:/pl/in 

The nth line containing /pi/ is copied to the string buffer. 
EXTRACT:/pl/T/p5/in 

Text is written to the string buffer beginning with the nth 
line containing /pi/. The copy terminates when a line 
containing /p2/ has been transferred. 
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3.1.1.L FIND {F> 

Lists the nth line or the nth line containing /phrase/. 

The search-pointer is set to the nth line or to the nth 
line containing /phrase/. IF n is set to a value greater 
than what exists between current file position and EOFt 
the search-pointer is set to EOF or to the last occurrence 
of /phrase/. The search-pointer is unaltered if /phrase/ 
cannot be found. Valid forms of the command are: 

FINO-in 

Advances the search-pointer n lines and lists the line 
denoted by the new value of the search-pointer. 

FIN]);/pl/-Tn 

Advances the search-pointer from its current position to 
the nth line containing /pl/n and lists the line. 

FIND:/pi/i/pS/in 

Same as above with the exception that if phrase denoted 
by /pl/i/pS/ is multi-linei all lines associated with 
/pl/n/pS/ are listed. 
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3.1.1.7 LIST -CLl Page a-S 

Functions the same as FIND except that the search-pointer 
is unaltered■» and n lines containing /phrase/ are listed. 

3.1.1.a NUMBER -CNl 

Counts the number of lines or the number of lines containing 
/phrase/ from the search-pointer to end of file. Valid 
forms of the command are: 

NUMBER 

Returns to the user a line count from current file position 
to EOF. 

NUMBER:/phrase/ 

Counts the number of lines containing /phrase/ and returns 
this value to the user, /phrase/ may be of a simple form 
/pi/ or complex /pl/i/pE/. 
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3.1*5 String Commands 

One main difference between line and string commands is the 
search mechanism employed to process /phrase/ for n > 1. 

For a line command t as each occurrence of /phrase/ is processed! 
the search for the next occurrence begins with the next line. 

With string commands! the search for the next occurrence of 
/phrase/ begins with the next character in the current line. 

The search-pointer is unaltered for all string commands except 
FINOS. All string commands with /phrase/ as a null function 
are processed as if they were a line command. Otherwise they 
are implemented in the following way. 

3.1.5.1 ADOS {AS> Page 5-6 

I A character string is added to the edit file immediately 

following each occurrence of /pi/. 

3.1.5.5 BLANKS IBS} Page 5-11 

One or more occurrences of /phrase/ are replaced by blanks. 

3.1.5.3 CHANGES {CS> Page 5-7 

j One or more occurrences of /phrase/ in the edit file are 

deleted and replaced by a character string entered in 
response to the editor request ENTER TEXT. If the replace¬ 
ment string is shorter than /phrase/! the line or lines 
containing /phrase/ are shifted to the left creating as 
many lines as necessary. Any completely blank lines 
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generated are deleted* If the replacement string is longer 
than /phrase/ the last line containing /phrase/ is right 
shifted the number of excessive characters. 

3.1.2.M DELETES IDS} Page 2-T 

One or more occurrences of /phrase/ are deleted from the 
edit file. The affected lines are shifted to the left to 
close the gap left by the deleted character string. Any 
I completely blank lines generated are discarded. 

3.1.2.5 EXTRACTS {ES> 

Causes the nth occurrence of /phrase/ to be copied to the 
string buffer following the last entry written to scratch 
file SCR2. Valid forms of the command are: 

EXTRACTSin 

Same as EXTRACT in. 

EXTRACTS:/pl/in 

Character string denoted by /pi/ is written to the string 
buffer. 

EXTRACTS:/pl/-./p2/in 

The nth occurrence of character string /pl/T/p2/ is copied 
to the string buffer. If n occurrences of /phrase/ cannot 
be found 1 the transfer is not performed. 
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a.l.S.b FINDS {FS> 

Lists the nth occurrence of /phrase/ and sets the search- 
pointer to that line. If /phrase/ is multi-line-i the 
search-pointer is set to the line containing /pi/. If n 
is greater than the number of occurrences of /phrase /1 
action is taken on the last occurrence of /phrase/. Valid 
forms of the command are: 

FINDS^n 

Same as FINDin. 

FINDSt/pl/in 

Advances the search-pointer to the line containing the nth 
occurrence of /pi/ and lists the phrase. 

FINDS:/pl/-./p5/in 

Same as above except that character string denoted by 
/pl/i/p5/ is listed. 

3.1.5.? INSERTS -CIS> 

Same as ADDS except that text to be inserted is imbedded 
within the command. Insert action begins at the current 
search-pointer value and inserts as many times as indicated 
by the specifier. Format of the command is: 
INSERTS:/pl/-,/p5/in 

The character string denoted by /p5/ is inserted immediately 
after each of n occurrences of /pi/. 


AA 3777 


PRINTED IN USA. 



CONTROL DATA CORPORATION 
■-DIVISION 

DOCUMENT CLASS__ PAGE Kin IX 15 Rev A 

PRODUCT NAME_ KRONOS 5.1 __ 

PRODUCT MODEL Kin £066*5.1 _MACHINE taOOQ/CDC CYBER 7Si7 3i7M 

3.1.2.8 LISTS -CLSl Page 2-2 

Causes one or more occurrences of /phrase/ to be listed. 

3.1.2.'! NUMBERS {NS> 

Counts the number of occurrences of /phrase/ from the 
search-pointer to end of file. Valid forms of the command 
are: 

NUMBERS 

Same as NUMBER. 

NUMBERSr/phrase/ 

Counts the number of occurrences of /phrase/ and returns 
this value to the user, /phrase/ may be of the simple 
form /pi/ or complex /pl/i/p2/. 

REPLACES -CRS} 

Same as CHANGES except that replacement text is imbedded 
within the command. Substitute actions begin at the 
current search-pointer value and substitutes as many times 
as indicated by n. Valid forms of the command are: 

REPLACES:/pl/nn 
Same as DELETESt/pl/in. 

REPLA CES:/pl/-,/p2/in 

Each of n occurrences of character string /pi/ is replaced 
with phrase /p2/. 


3.1.2.10 


I 
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3.1«3 Auxiliary Commands 

This category includes all commands which do not subscribe to 
the pecularities of either line or string operations. Note 
that certain of these have no abbreviated formi while other 
{notably MERGE and TAB> assume different information in 
/phrase/ and specifier fields. 

3.1.3.1 ALIGN {AL> Page 5-15 

Use to eliminate unwanted blanks within a file. Text is 
lined up by wordn sentence and paragraph. A word is defined 
as a set of characters between spaces. A sentence is a 
group of words ending with a period. A paragraph is defined 
as an indented sentence. 

3.1.3.5 CLEAR {CL> Page 5-M 

Returns scratch file SCR5 {also referred to as the string 
buffer} for subsequent use with EXTRACT operations. 

Specifier and/or /phrase/ are not requiredi and if present 
are ignored. 

3.1.3.3 DEFTAB {DT} 

Defines a TAB character to be used while structuring lines 
from data entered in response to an ENTER TEXT request. 

When defining a TAB character! the simple form of /phrase/ 
must be usedi and contain only one character. A previous 
definition will be cleared if /phrase/ is omitted. This 
specifier! if present! is ignored. Valid forms of the command 
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are: 

PEFTAB 

Clears tab character definition- 
])EFTAB;/pl/ 

Defines character pi as a tab character. 

3.1.3. H END Page 2-m 

This command terminates an editing session. 

3.1.3.S LENGTH 

Sets the maximum number of lines to be processed in the 
j edit filei and resets the search-pointer to the first line. 

The line limit is contained in the specifier n. If n=*i 
the original processing boundaries are restored-i i.e.i BOI 
and EOF. The purpose of this command is to reduce overhead 
by temporarily changing the length of the edit file to a 
size at which editing operations are directed. Valid forms 
of the command are: 

LENGTH^n 

I Truncates the edit file at line n. All data beyond line n 

is copied to a scratch file SCR3. 

LENGTH,* 

Restores edit file to its original length. The contents of 
scratch file SCR3 is appended to the edit file. 
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a.l.a.t. LINE -CLN} 

Lists the number of the line at which the file is currently 
positioned -Ci.e.i the value of the search pointer}. 

3.1.3.7 LISTAB -CLTl 

Lists the columns at which tab stops are set. 

3.1.3.6 MERGE -CM} 

Merges a file into the edit file. The syntax of this command 
deviates from normal in that the name of the file to be 
merged is passed in /phrase/. If merging is to Occur rela¬ 
tive to a specific character stringi the complex form of 
/phrase/ must be used. In this Case the character string 
of interest is found in /p2/. The file is merged with the 
edit file after the nth line or after the line containing 
the nth occurrence of the string specified in /p5/. If the 
merge file is not local t an attempt is made to retrieve it 
as an indirect access permanent file. Valid forms of the 
command are: 

MERGE:/lfn/nn 

The contents of file Ifn are merged into the edit file. 

Merging takes place after the nth line {relative to the 
search-pointer}. 

MERGE:/lfn/-./p5/nn 

The contents of file Ifn are merged into the edit file after 
the nth line containing /pS/. Merging takes place only if 
n lines containing /p5/ are found. 
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3.1.3.T RESET -CRl Page 5-4 

This command brings the search-pointer back to the first 
line of the edit file. 

3.1.3.10 SET -CS} Page 5-3 

Sets the search-pointer within the edit file. If specificator 
is *1 then the search-pointer is set to EOF. Otherwise the 
search-pointer is set to n lines beyond the current setting t 
or to the nth line containing /pi/. 

3.1.3.11 TAB -CT> 

Set tab stops according to the contents of /phrase/-i which 
contains less than or equal to seven tab values. Default 
tab columns are 11 t 16-» 30i 40 and SO -Csee DEFTAB>. Format 
of the command is: 

TAB:/t1 1 ...tn/ 

Sets tab stops at columns t£. 

3.1.3.15 UIDTH -CU> 

Defines a column at which point line assembly will terminate 
when executing the ALIGN command. Definition is taken from 
the specifier field and must be less than or equal to 13ti. 
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Teletype Messages 


Error Messages 

These messages indicate a condition exists such that a 
command cannot be processed. 


3.1. M.1.1 PHRASE NOT FOUND. 

The character string specified in /phrase/ was not found. 

3.1. M.1.2 ILLECAL COMMAND. 

Command word is invalid. 


3.1.M.1.3 cmd SYNTAX ERROR. 

Either /phrase/ and/or specifier is illegal with 
command cmd. 


3.1. M.1.M ILLEGAL FILE NAME. 

File name passed with MERGE command or when invoking the 
Editor is illegal. 

3.1. N.1.S MERGE ERROR-. SECONDARY FILE EMPTY. 

I File to be merged with edit file is empty. 

3.1. M.l.b RESERVED FILE NAME. 

File name passed with MERGE command or when invoking the 

Editor is reserved for use by the Editor. Reserved file 

names are: 

INPUT 

OUTPUT 

SCR 
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SCRl 

SCRS 

SCR3 

SCRM 

SCRS 


3.1.M.1.7 CONTROL CARD ERROR. 

More than one parameter was passed when calling the 
Editor. 
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3.1. M.2 Informative Messages and Diagnostics 

3.1. M.2.1 BEGIN TEXT EDITING- 

Issued when initialization of Editor is complete-i and 
awaiting the first command. 

3.1. M.2.2 ENTER TEXT FILE NAME. 

Issued when text file name not passed with Editor call. 

3.1. M.2.3 ENTER TEXT. 

New or replacement text is required to process ADD {ADDS} 
or CHANGE {CHANGES} commands. 

I 3.1.M.2.4 m OCCURRENCES OF PHRASE FOUND- 

Passed when some-i but not "n”n occurrences of /phrase/ were 
found and processed. 

3.1.4.2.S m LINES TO EOF- 

Line count message issued by NUMBER command processor. 

3.1.4.2.b - END OF FILE - 

Edit file is currently positioned at end of information 
{EOI}. 

TAB STOPS t, tn -. .t 

ii c n 

Message issued by LISTAB processor. 

READY 

Issued when input of new or replacement text is complete. 

This indicates that the EDITOR is ready to accept the next 
command. 


3.1* M.B*? 


3.1j. M.2.6 
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FILE AT LINE NUMBER XXXXXX. 

Message passed by LINE command processor. XXXXXX is the 
current value of the search pointer. 

3.1.M.5.ID END TEXT EDITING 

The last word-Csl in editing. 


AA 3777 


PKINTB) IN USA. 




2.0 APPLICABLE DOCUMENTS 2 

3.0 DESCRIPTION 3 

3.1 Introduction 3 

3.2 General Description 3 

3.3 User Control S 

3.3.1 Media and Mode 5 

3.3.2 Checkpoint Output Specification S 

3.M Checkpoint/Restart Requests fl 

3.M.1 Checkpoint fl 

3. *4.2 Restart 11 

3.5 File Processing 13 

3.5.1 Non-Permanent Mass Storage Files 13 

3.5.2 Tape Files 13 

3.5.3 Permanent Files 13 

3.5.4 Restrictions 14 

3.b Checkpoint Examples 15 

3.7 Messages 17 

4.0 DEFINITIONS IT 

APPENDIX A - Direct Access PF Processing A-1 

APPENDIX B - Restarting Direct Access Files B-1 


AA S777 


nwncDiNusA. 



CONTROL DATA CORPORATION 

. . .DIVISION 

DOCUMENT CLASS__ PAGE NO.-X_1_ 

PRODUCT NAME_ KRONOS a»l _ 

PRODUCT MODEL md EOflfi^a.l _MACHINE <;PRii=«; CYBER ?aT7 3i7M 


1.0 SCOPE 


1.1 These specifications provide the characteristics of the 
Checkpoint/Restart feature. 
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2.0 APPLICABLE POCUMENTS 

2*1 KRONOS Version 2.1 Product Objectives Document 
SCOPE 3.M Reference flanual 
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3.0 DESCRIPTION 

3.1 Introduction 

There exists at any time the possibility of system or job failure. 

For some jobs it becomes more advantageous to accept the overhead 
of checkpoint procedures than to run the risk of losing the entire 
job output. 

To checkpoint a job is to save enough information during the job 
to be able to restart it from some intermediate point of execution. 

3.5 General Description 

Checkpoint temporarily stops execution of a job and captures the 
total environment of the job and its resources onto a file. 

Restart can then rebuild the job at a later time from this file. 

The elements of the job's environment must be under the control 
of the job itself in order for the Checkpoint/Restart facility 
to produce the desired results. 

The Checkpoint/Restart facility may be called either by a control 
card statement! COMPASS macron or other language specification. 

The data representing the environment of the job may be written 
to a tape filei or one or two mass storage files. 
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The following information is recorded: 

— Job Control Information - including exchange packagei 
job name and internal flags. 

— User memory 

— Namesi file positions! and if specified! contents and 

related information of all tape files assigned to the job. 

—Names! file positions! and if specified! contents and 

related information of all local files attached to the job 
including: 

Sequential mass storage files 
Random mass storage files 

Direct access permanent files -Csee Appendix A} 

Common files 
Library files 


The programmer is allowed the option to select which files are 
to be copied. In the case of tape! common! library and some 
direct access files! he may select whether or not the contents 
of each file will be copied. Execute only files will not be 
copied! however. Direct access files that are not read only 
will be treated like local mass storage files and the contents 
recorded -Csee Appendix A}. Restart will restore the job's 
environment from this checkpoint area. 
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3.3 User Control of the Checkpoint Operation 

Most of the characteristics of a checkpoint data file are speci¬ 
fied by Checkpoint/Restart. The filei howevern is local to the 
job and certain options may be selected by the user. These 
I include labels^*! media and mode. 

3.3.1 Media and Modes of Output 

The media of the output is the destination of the data and may 
be tape or mass storage file. 

The mode of writing the output can be selected as extend by 
writing at end of information! rewrite at beginning of informa¬ 
tion! or by writing alternately on two checkpoint files. 

3.3.2 Checkpoint Output Specification 

The user may specify both the media and the mode of the file by 
RE(2UEST statements or macros. The request statements may be 
used to specify either mass storage or tape. An additional CK 
parameter identifies the file as the checkpoint destination 
file and specifies mode. For example: 

Control Card Call* 

RE(2UEST-Cfile!CK} 

or 

RE(2UEST{file!CB} 


* See Batch User’s Reference Manual and Tape Labels! kSX Support ERS 
for additional request card parameters. 

** The user is responsible for handling all tape label requests. See 

Tape Labels! tSX Support ERS- 
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A comment may be added to specify that a mass storage or tape 
file is required. 

REflUEST-Cfile-iCKl TAPE FILE. 

— file Name of file required. 

— CK Extend file by writing new checkpoint data at end 

of information. May be tape or mass storage. 

— CB Rewrite new data at beginning of information. Hay 

be tape or mass storage. 


Macro Call 

REQUEST addr 

addr = FET address. 

■Caddr+1} = MS or MTi left justified! to indicate a mass 
storage or tape file. 

■Caddr+7} = Checkpoint IDi left justified. 

7bB — Urite at end of information. 

7SB — Urite at beginning of information. 

If two files with CB specified are present! checkpoint will 

alternate by writing first on one file and then the other. 

More than two checkpoint files or two files with CK specified 

will cause a program abort. 
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3»3.2»1 Additional Provisions 

If the user wishes to write checkpoints on alternate filesi 
both files must be specified as checkpoint filesi otherwise! 
the checkpoint operation will write at the BOI on the one 
specified file. 


The user is responsible for making his checkpoint file-Csl 
permanent if he desires that they be permanent. If a tape 
file is not specified and the user desires that the checkpoint 
file-Cs} be permanent! he must either define the file-Cs} to be 
direct access before the checkpoint! or save them afterwards. 
Checkpoint considers the file to be local and will not make 
it permanent. 


A direct access file used as checkpoint output must have URITE 
permission. For example! to checkpoint to a new direct access 
file called FILE! the following sequence of control cards 
could be used: 

]>EFINE{FILE/I1=li)} 

REi3UEST{FILE!CK} 

CKP. 

-CThe CKP control card is described in Section 3.'4.> 


3 . 3 . 2 .B Default Checkpoint Output 

If no file has been specified! a file with the name CCCCCCC 
will be written. 
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3.M Checkpoint/Restart Requests 

3.M.1 Execute Checkpoint 

The CKP control card statement! an operator commandi or the 
CHECKPT macro may be used to request a checkpoint. 

The general control card formats are; 

CKP. 

CKPClfn^^ilfn^i* •-Ifn^^l 
where 

lfn£ = names of files to be checkpointed. 

The first form implies that all files local to the job will be 
checkpointed. The second form designates the set of files to 
be checkpointed {INPUT-. OUTPUT-. PUNCH-. PUNCHB and LGO will 
always be included}. The information saved for each file 
depends on the file type and is discussed in Section 3.5. 

An operator may enter the DSD commands: 
n.CKP. 

to specify a checkpoint where: 

n = Control point of job to be checkpointed. 

I The result of this command is the same as for the comparable 

control card. 
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The macro format is: 

CHECKPT paramisp 
where: 

param = address of parameter list 

sp = 0 checkpoint all files {default}* 

^ D checkpoint only files specified on list* 


S'! 


17 11 


□ 


Param 

Param 

Param 

Param 


+ D 


r* 

n 

L 


+ 1 

1 

fl 


+ a 

Ifng 

fa 




+ n 


fn 



n = number of Ifn entries in list — maximum is 77 {octal}* 
{n = 0 overrides sp □*} 

Ifn^ = local file name left justified* 


f£ = octal number specifying manner in which Ifn is to be 

processed {type of copy}* 

0 The file is copied from beginning of information 
to present position* Restart will position the 
file at the latter point* 

1 The file is copied from its present position to 
end of information* The file is positioned at 
the former point* 

5 Entire file is copied* The file is positioned 
at its position at checkpoint time* 

3 The last operation on the file determines how the 
file is copied. 
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*4 Information table on file is copiedi but file it¬ 
self is not copied {default for tapei common i 
library and direct access {read only and execute} 
files. {The information table contains FNT/FST 
information as well as copy type and the random 
address.} File will be retrieved at restart and 
positioned at its position at checkpoint time. If 
file is local and assigned to mass storage and has 
copy type M specified! RESTART will assume that it 
is an indirect access file and will do a GET. 

If n = Dt all mass storage files will be copied to the check¬ 
point file in the manner determined by the last operation {i.e.i 
read or write}. 


If n t Di all mass storage files named in the list will be 
copied as noted by the f flagsi howeveri system mass storage 
files {INPUT-. OUTPUT-. LG0-. PUNCH-, and PUNCHB} will be copied 
as determined by the last operation on each files as follows: 
f = 0 if file was written, 

f = 1 if file was read and EOI was set. 

f = 2 if file was read and EOI was not set. 

If sp = 0-. but n ^ □-. the list will be used to determine copy 

types-, but all files will be checkpointed. 

Checkpoints are numbered consecutively beginning at {1} for 
each checkpoint file. A file with CK mode specified will 
consist of checkpoints 1 to n-. where n is the number of the 
last checkpoint taken in that series. A checkpoint file with 
CB mode specified will consist of checkpoint n where n is the 
consecutive number of the last checkpoint written to that file. 
The user should note that if alternate files are specified 
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each file will be processed individually for checkpoints 1 to n» 

That isi both files may contain a checkpoint b -Cn = bJi but they 
will be differentiated by date and timei the earlier one being 
used for the next checkpoint. 

For example-! file ABC may contain checkpoint M taken on 75/07/30 
at m.OS.OO. and file DEF may contain checkpoint H taken on 
75/07/30 at IS.15.00. Thusi ABC contains the seventh checkpoint 
of the series and DEFi the eighth. The next checkpoint will 
write the data to file ABC as checkpoint S of that file and 
ninth in the series. 


3.M.5 Restart 

The Restart control statement is used to resume a job from the 
contents of a checkpoint file. 


The control card format is: 

RES TA R T-Cf i lenRI-.N AF C> 
where: 

file = checkpoint file name - must be present. 

n = number of the checkpoint from which to restart. If not 
specified-! 1 is assumed. If n = *-! the last available 
checkpoint on "file" is used. 

RI = If this parameter is present-! the INPUT file on check¬ 
point file is not to be restored. The INPUT file of 
the RESTART job at its current position is used by the 
restarted job. 

NA = No abort option. Restart will abort if all files 
needed are not available unless the NA option is 
present. Also-! if NA is present-! a read parity error 
will result in the RESTART of checkpoint n-1 if it is 
available. 
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FC = File check option. If this parameter is seti RESTART 
will check to see if each file is already present t and 
will not replace the file if it is there^ This allows 
the user to restart with one or more files changed. 
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3.S File Processing 


3.S.l Non-Permanent Hass Storage Files 

The following information is recorded for each local mass 
storage file included in the checkpoint: 

— n ame 

-- all job related information for the file. This will 
include file position! description! and status. 

— contents of the file if specified. 

3.S.5 Tape Files 

The following information is recorded for tapes assigned to 
the job: 

— name 

-- all job related information including file position! 
description and status. 

-- contents of file if specified. -CAt restart time! RESTART 
will request a tape of the same name. The information 
will then be copied to that tape and repositioned.} 


3.S.3 Permanent Files 

The following information will be recorded for permanent files: 

— local file name 

— all job related information! including file position! 
description! status and access mode. 

— contents of the file unless read only direct access or 
execute only file {see Appendix A}. 
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3.S.M Restrictions 

Random files must have copy type 5 {entire file} specified in 
the parameter list or they will be copied as per last status* 

AIsot a maximum of 500 {octal} files will be checkpointed- 

Restarting jobs which created or purged permanent files since 
the selected checkpoint may not produce proper results- A 
restart may be rendered useless if any of the permanent files 
have been changed or deleted outside of the job- The user must 
also insure that any tape files•» common files and/or permanent 
filEs needed are available for the RESTART. RESTART cannot 
correctly process permanent! commom or library files that have 
been renamed since the last checkpoint. Execute only files 
will not be checkpointed and this will cause RESTART to abort 
when it cannot retrieve these files {see Appendix A}. The user 
can overcome this by using the NA and FC options on RESTART 
and retrieving the files himself. If FC is not selected! all 
files present at restart time will be rewound and then copied 
to. The user should avoid having read only or execute only 
{or any with write lockout set} files at his control point or 
restart will abort attempting to write to those files* 

Files CCCCCCC! CCCCCCi! CCCCCCO and CCCCCCM are used by check¬ 
point and should not be used by the user. 
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All files copied by RESTART will be made local files- See 
Appendix B for an example of how direct access permanent 
files may be handled. 
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3«b Checkpoint Examples 
For COMPASS users: 

CHECKPT PARAM 

■ 

PARAM DATA 0 

All mass storage files would be processed Csp = Qi n - 01 at 
checkpoint. 

For FORTRAN {RUN> users: 

DATA variable/D/ 

CALL CHEKPTR {variable} 
or 

variable = Q 

CALL CHEKPTR {variable} 

For FORTRAN EXTENDED users: 

DATA variable/D/ 

• 

9 

9 

9 

CALL CHEKPTX {variable} 
or 

variable = 0 

CALL CKEKPTX {variable} 
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For COBOL users: 

RERUN ON Ifn^ EVERY END OF n RECORDS OF Ifng 

This will cause a checkpoint file to be written to file *lfn^* 

after n records of *lfng* are processed. {See COBOL M-D Reference 
flanual.} 


For the preceding examples t checkpoint processing is performed 
for all mass storage files as described in the first example 
where sp * 0-» n = 0. 


Selected files may be processed in the manner shown in the 
following example: 


DIMENSION KPARAM {41 

KPARAM {11 = 300QDB {Indicates 3 files on 

listl 


KPARAfI {SI = SLTAPE .OR. 2DD0Q0B {Specifies file with 

copy type 21 

KPARAM {31 = bLTAPE23 .OR. lODDQDB {Specifies file with 

copy type 11 


KPARAM {41 = SLTAPE3 


{Specifies file with 
copy type 01 


CALL CHEKPTR {KPARAMill FORTRAN {RUNl 

or CALL CHEKPTX {KPARAMnll FORTRAN EXTENDED 
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3.7 Messages 

3.7.1 Dayfile Messages 

» CHECKPOINT FILE ERROR.» 

Format error or illegal checkpoint file detected. {Issued by 
CHKPT or RESTART.! 

» CHECKPOINT nn COMPLETE.» 

Checkpoint number nn has been completed. {Issued by CHKPT.} 

» CHECKPOINT NOT FOUND.* 

The specified checkpoint number was not found- {Issued by 
RESTART.} 

* CKP REQUEST.* 

A checkpoint has been initiated. {Issued by CHKPT.} 

* ERROR IN ARGUMENTS.* 

Incorrect parameters were encountered. {Issued by RESTART or 
CHKPT.} 

% ERROR - FILE{S} NOT PROCESSED.* 

Address errors were encountered on the fileCs} during preseti 
therefore they were not checkpointed. {Issued by CHKPT.} 

* FILE ERROR - name.* 

An illegal address was encountered on file ^f^name^Ci therefore 
it was not repositioned. {Issued by RESTART or CHKPT.} 
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» name NOT FOUND.* 

File 'name* could not be found or retrieved at restart time. 
•CIssued by RESTART.} 
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M.D DEFINITIONS 

M.l ALTERNATE URITE 

Method of checkpointing in which the Checkpoint file is written 
first to file A and thenn during the next checkpoint •» it is 
written to file B and so oni switching from A to B and back at 
each successive checkpoint. 

M.5 CCCCCCC 

Default Checkpoint file name. The user should not use this name- 
M.3 CHECKPOINT 

Procedure of saving all pertinent information from-a job in order 
to be able to continue from that point at a later time. -CSee 
RESTART.} 

M.M COPY TYPE 

Manner in which a file is processed. It depends on the last 
operation {read or write} performed on the file unless set by 
the user in his file list. 

M.S DIRECT ACCESS FILE 

A permanent file which the user has direct use ofi that isi the 
file is not copied to his job. 

M.b MEDIA 

Destination of the checkpoint data and may be tape or mass storage. 
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M.7 MODE 

Manner of writing the checkpoint data* Can be write at BOI or 
write at EOI. 


M.fl RESTART 


Procedure of rebuilding a job’s environment from a Checkpoint 
file in order to continue that job. 
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APPENDIX A 

DIRECT ACCESS PF PROCESSING 


Table of access modes and checkpoint procedure for direct access files 
{see Section 3.^.1 for f definitions}. 


NODE 

DEFAULT 

USER OPTION 

READ ONLY 

NOT COPIED {f=M} 

ANY TYPE OF COPY {f=l-. S-. 3 or H} 

EXECUTE ONLY 

NOT COPIED {f=M> 

NONE 

APPEND ONLY 

COPIED {f=3} 

ANY TYPE OF COPY {f=l-, St 3 or ^y* 

WRITE 

COPIED {f=3} 

ANY TYPE OF COPY {f=l-. S-. 3 or M}* 

MODIFY 

COPIED {f=3> 

ANY TYPE OF COPY {f=l-. 2-. 3 or Ml^tc 

READ and APPEND 

COPIED {f=3} 

ANY TYPE OF COPY {f*!-. 2-, 3 or M}* 

READ and MODIFY 

COPIED {f=3} 

ANY TYPE OF COPY {f=l-. 2-. 3 or M}* 


* If f=4 is selected! the user must retrieve the file himself at 
RESTART time and select the NA and FC options on RESTART {see 
Section 3.M.5}. 
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APPENDIX B 

RESTARTING DIRECT ACCESS FILES 

All files copied by RESTART will be made local to the restarted job. 
Therefore! the user must take certain steps to insure that his direct 
access files will not be lost. 

For example: 

Job A has direct access files X-i Y and Z attached to the job. 

Job A is then checkpointed and Xn Y and Z are copied to file 
♦CHECK*. To retain these files as direct access filest the 
restart job would contain the following sequence of control 
statements: 

PURGE-CXiYnXl 

DEFINE-CXiYnZ} 

RESTART-CCHECKn*} 

Thusi RESTART will restart the job from the last checkpoint on 
file *CHECK*-i and will copy X-i Y and Z to their respective newly 
defined files. 

Direct access files that are not to be copied will be attached in the 
mode specified by control bits in the FNT for each file. If the mode 
thus specified is not recognized-* the file will be attached in read 
mode. 
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l.D SCOPE 

These specifications describe the external characteristics of 
those new or modified features incorporated into the KRONOS 5*1 
operating system to standardize the KRONOS Transaction Subsystem* 
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KRONOS Version 2»1 Product Objectives Document 
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SIlSObDOl 

KRONOS 2*0 Instant Manual {publication number ST1S210Q> 

KRONOS 2*0 Operating Guide {publication number STlSlbDQ} 
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3.0 DESCRIPTION 

3.1 Terminal Network Description 

In order to provide a description of the KRONOS terminal network t 
two programs are provided: 

CONCRTN which reads and interprets a set of network descrip¬ 
tion directives. 

VALNET which validates a terminal network description file. 
Terminals in the network are assigned various attributes by 
providing the system a record of coded card images that is 
interpreted by common deck COUCRTN- These descriptions are 
ultimately used by TELEXt TRANEX-i and the Stimulators. 

3.1.1 Common Deck COfICRTN 

COMCRTN provides common logic to process a caller provided 
record of terminal descriptions. Entry is via location ATD. 

ATD reads and interprets cards to describe a single terminal 
and forms a table based on information found. 

3.1.1.1 Terminal Description Format 

Terminal network description consists of a set of directive 
cards describing each terminal in the network. Cards may 
be up to columns 1 but only columns 1 through 7S are 
examined by ATD. Any card containing an asterisk in 

column 1 is considered a comment card and is ignored. 
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Terminals are grouped into sets by the multiplexer through 
which they communicate with the system- Each set is intro¬ 
duced by a mux definition in the following format: 
//muxtypenpl=nTp5=n 

where muxtype is a multiplexer type designation and pi and 
pB specify various attributes of the mux. 

A terminal is considered to belong to the mux set begun with 
the preceding mux definition statement. 

Each terminal description is begun by a terminal name 
directive in the format: 

/n amen am 

where namenam is a user-assigned terminal name. The slash 
■C/} is mandatory and must immediately precede the terminal 
name which may be any 1 to 7 alphanumeric characters. 
Following the terminal name and separated by commas are 
various arguments describing terminal characteristics in 
the form: 

/namenamTpl=aaaaTpB=nnnnnnT... 
where namenam is the assigned terminal name and pi is an 
attribute mnemonic that is to be assigned a value of aaaa 
or nnnnnn. 

In the following argument descriptions! alphanumeric argu¬ 
ment values are denoted by "aaa" and numeric argument values 
by "nnn". Numeric values may be specified in either octal 
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or decimal base by including a or "D" radix symbol 
immediately after the number. In the absence of a radix 
symbol 1 decimal base is assumed. Each terminal description 
may span several cards and spaces between arguments are 
ignored. If errors occur in a description! ATD exits with 
a flag value in XI. After ATD is entered for the next 
description-I it skips characters until a is encountered 

and then begins anew. 

The description file is expected to be properly positioned 
upon entry to ATD. 

Programs that use COMCRTN may place further restrictions 
upon argument values than those stated below. It is best 
to consult appropriate documentation for those programs 
before writing terminal descriptions. 
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3»1»1»5 Table Format 

After each terminal description has been assembled-i ATD 
returns to the caller. Terminal description argument values 
reside in the following locations: 

TN. Terminal Name. 

1-7 left justified! zero filli characters. 

DB> Data Base Name.* 

2 left justified characters. 

IS. Initial ON/OFF Status.* 

Binary 0 or 1. -Cl = OFF} 

LS. Line Speed in characters per second. 

Binary value from 1-3777B. 

PC. Polling Code. 

2 M bit binary value. 

PN. Port Number. 

Packed floating point format value. Coefficient 

is the port number from D-b3. If exponent is 
non zero -1 a range of ports with identical terminals 
is defined. In this case-i the exponent is the 
number of ports in the range - 1. 

RS. Data Base Read Security.* 

3 bit binary value. 

TT. Terminal Type. 

Binary value defined by symbol in common deck 
*C0f1SNET*. If bit 11 is seti terminal is a KTS 
terminal. 

UA. User Arguments.* 

BM bit binary value. 

US. Data Base Update Security.* 

3 bit binary value. 

NT. Nultiplexer Type. 

Binary value symbolized in common deck *C0NSNET*. 

CH. Nultiplexer Channel. 

Packed floating point format value. Exponent is 
zero! coefficient is channel. 
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E(2. Multiplexer Equipment Number. 

Packed floating point format value. Exponent is 
zeroi coefficient is equipment. 

* KTS Terminal Argument. 
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Interface Requirements 


ENTRY 

•CXS> = Address of FET for description file. 


•CAOJ = Address of a word that describes a table that COflCRTN 
may use to store terminal names. Uord format: 


-C-CAD}} 



M7 


2 ^ 


LENGTH 


FUA 


where: 

LENGTH = maximum length table may attain* 
FUA = first word address of table. 


•CBll = 1. 

EXIT 

•CBll = 1. 

fXll ^ 0 if error encountered in description file. 


If -CXll t 0-. then: 

•CXH> = Address of error message. -C^C* format} 

•CXm = Card number of offending card. If -CXM} = 0i no 
description cards were found in the record. If 
•CXm < Di this is not an error i but end of record 
was encountered. 

•CXQ} = address of card string buffer. 


DOES NOT USE 

A “ 0. 

X - S. 
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CALLS 

CIO=il>XBiRI>S = . 

REQUIRES 

Common deck COMSNET. 
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Network Description Argument Specification 

Multiplexer Description Argument Formats 
Example of multiplexer description: 

//tt7b-.CH=l-.E(2=M. 

The field "muxtype" mentioned above has been assigned a 
value of "bbTb" and the "pi” and "p5" arguments are used 
to define the mux channel and equipment numbers. 

3.1.1. M.1.1 Multiplexer Type 

//aaaa 

** Mandatory to initiate a set of terminal descriptions. 
Describe multiplexer of type aaaa. aaaa may be: 
til37tj for a tit7b multiplexer 
bb71 for a tit71 multiplexer 

3.1.1. M.1.5 Multiplexer Channel 

CH=nn. 

** Mandatory argument on multiplexer description. 
Declares the multiplexer channel, nn may range from 
0 to 13 and 20 to 33 octal. 

3.1.1. M.1.3 Multiplexer Equipment Number 

E(3=n. 
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3.1.1. M.S Terminal Description Argument Format 

Example of time-sharing terminal description. 
/XXX-,LS=lQ-.PN=l-iTT=AB. 

Example of KTS terminal description. 

. /C02DDlA-,DB=LC-iIS=0N-,LS=lS-.PC=S0B-.PN = 3-.RS = M-.TT=*NIX-, 
UA=D1S7DDB-.US = M. 

Herei the field "namenam" mentioned above is used to assign 
names "XXX" and "CDSDQIA" to specific terminals. The 
arguments ”pl”-i "p2”t etc.n are used to describe the 
attributes of these specific terminals. 

3.1.1. M.2.1 Terminal Name 

/aaaaaaa 

** Mandatory to describe a terminal. 

Defines the terminal name aaaaaaa. aaaaaaa may consist 
of 7 or less alphanumeric characters. 

3.1.1. M.2.2 Data Base Name 

DB=aa . 

**■ KTS terminal argument. 

Declares the data base to be used by terminal, aa may 
be any legal 2 character data base name. 
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Initial Status 
IS=aaa. 

** KTS terminal argument. 

Declares the terminals initial on/off status, aaa may 
be ”0N” or "OFF”. Default value is "ON". 


3.1.1.M.S.M Line Speed 
LS=nnnn. 

Declares the terminal line speed {character rate}, nnnn 
is in characters per second and values may range from 1 
to BDM7. 


3.1.1.M.5.5 Polling Code 
PC=nnnnnnnn. 

Defines the terminal polling code, nnnnnnnn may range 
from D to lb77721S {2M bits}. 


3.1.1.M. 2.(3 Port Number 
PN=n. 

** Mandatory argument. 

Declares the port number of this terminals line, n may 
range from 0 to b3 if multiplexer is a bb7tii and may 
range from 0 to IS if multiplexer is a bb71. 


3.1.1.M.2.7 Port Range Limit 
PL=n. 

Defines the limit of a range of ports for a set of 
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identical terminals, n may range from the previous 
declared port number "PN" + 1 to b3 for a bbTb multi- 
plexer-i or to IS for a bb?! mux. The "PN" argument 
must appear previous to the "PL” argument. 

3.1.1.4.5.fi Data Base Read Security 
RS^n_^ 

** KTS terminal argument. 

Declares the data base read security, n may range from 
0 to 7. Default value is □. 

3.1.1.H.5.T Terminal Type 
TT=aaaaaaaa. 

Declares the terminal type, aaaaaaaa may be any one of 
the following: 

AB Terminal will be identified by answerback. 

ID Terminal will be identified by terminal 

operator entry. 

NIX "CYBERLOAN" NIXDORF terminal. 

If any one of the above terminal type mnemonics is pre¬ 
fixed by "*"n it is defined as belonging to the KTS 
terminal network. For example: 

TT=*NIX 

declares a KTS NIXDORF terminal. 
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3.1.1.M.5»10 User Argument 
UA=nnnnnn» 

** KTS terminal argument. 

Defines the contents of the user argument area, nnnnnn 
may range from 0 to llaTTTSlS {54 bits>. Default value 
is 0. 


3.1.1.4.5.11 Data Base Update Security 
US=n. 

KTS terminal argument. 

Declares the data base update security, n may range 
from 0 to 7. Default value is D. 
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3.1.S VALNET 

VALNET is a control card callable program that may be used 
to validate the syntax and logic of a terminal network 
description* 


VALNET reads a terminal network description written as a 
series of directives defined by the common deck ^COMCRTN*. 
Errors in network description are diagnosed and error messages 
are placed on a list file* If no errors are encountered! no 
listing is produced* 


3*1*5*1 Control Card Call 
VALNET-Cpl-,pa-.p3> 
where pi may be: 

P Terminal network description file name* 

P File ^COMPILE*. 

P=fn File xfn*- 

ABSENT File xNETlilORK*. 

L File to receive list of errors. 

L File *LIST*. 

L=fn File sttfnJC. 

L=Q No list. 

ABSENT File x^OUTPUT*. 

NR Do not rewind description file before reading* 

NR Do not rewind* 

ABSENT Rewind first* 
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3*]i>5*5 Listable Output 

Each error encountered produces 5 lines of listing. The 
lines consist ofJ 

1• The input line containing the error. 

This may be only near the bad line if the error is one 
of omission. That isn if line 3 describes terminal 
and line H describes terminal then if no port 

number was defined for terminal this is not 

diagnosed until the "/B" directive is encountered! 
therefore line M is listed along with an appropriate 
diagnostic message. 

5. Card number of offending card. 

This is subject to the same exceptions as noted above 
in item 1. 

3. A diagnostic message explaining the error. 

For example: 

/TERHl-.TT=lijHAT-,PN=3. 

CARD S3 UNKNOWN TERMINAL TYPE. 

List lines are formatted for printing on a 75 column device 
except for those input lines that exceed this length. 
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3«1>2*3 Dayfile Messages Issued 

* NO DESCRIPTIONS FOUND.* 

No mux/terminal descriptions were found on the description 
record. 

* FILE NAME CONFLICT.* 

The *P* file name is the same as the *L* file name. 

* TERMINAL DESCRIPTION ERRORS.* 

Errors were found in the terminal descriptions. Consult 
listing for diagnostic messages. 

* VALNET ARGUMENT ERROR.* 

The VALNET control card contains unknown or incorrectly 
used arguments. 

* VALNET COMPLETE.* 

All descriptions have been validated as correct. 

* TABLE OVERFLOW.* 

Not enough storage was available to hold all terminal 
description table entries. 
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3.S CPU Time Limit Handling 

CPU time limit may be expressed in seconds. KRONOS 5.0 rounds 
this time limit up to the next higher multiple of 5 seconds. 

KRONOS 5.1 will not round up. This gives system users better 
control over CPU time. Time limit setting to a precision of 
one second may be done via the job cardi the SETTL card or the 
SETTL COMPASS macro. All other external features are the same 
as KRONOS 5.0. 


AA 3777 


miNTCDINUSA 



CONTROL DATA CORPORATION 

___DIVISION 

DOCUMENT CLASS__ PAGE NO.-M_13- 

PRODUCT N/V1E_ KRONQS g. 1 __^_ 

PRODUCT MODEL na £065*5.1 _MACHINE SERIES fc^POD/CDC CYBER_75273 i7H 

3.3 Sub-Control Points 

The sub-control point feature allows a program executing at a 
normal system control point to supervise the execution of several 
independent sub-programs. This executive program controls the 
exchange packages and memory of the sub-programs. Each sub¬ 
program is assigned an exchange package and some subset of the 
executive's field length. Because of this exchange package 
control 1 the sub-programs are not subject to traditional constraints 
placed on overlays in regard to execution address. Sub-programs 
may be loaded and moved at will by the executive since all sub¬ 
program addresses are relative to the reference address -CRAl as 
specified in the exchange package. 

3.3.1 Sub-Control Point Execution 

3.3.1.1 XJP Request 

The XJP system RA+1 request is used to initiate the execution 
of a sub-control point. 
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Uhere: 

time = CPU time limit -Cin milli-seconds} for sub-control 
point execution. 

addr = address of sub-control point exchange package. 

After the XJP request is honoredi the sub-control point will 
execute until: 

1 . It requests system action via the execution of a central 
exchange jump instruction. 

5. The time limit as specified in the XJP request is exceeded. 
3. It causes a hardware error condition like a reference to 
an address that is out of its field length. 
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3>3*1.S Reply from CPUMTR after XJP request* 

In any of the above casesi the executive program is restarted 
and the following information is returned: 

{XI} = Milliseconds of CPU time used before sub-control 
point executed. 

{Xb> = 15/ 5□□□B+EF^^a/ RA of sub-control point* 

Where EF is an error flag caused by the sub-control 
point* EF may be: Q {if no errorli TLET {CPU time 
limit exceeded}! ARET {arithmetic error}i PSET 
{program stop}* 

{X?} = Milliseconds of CPU time used by sub-control point* 


If an error is encountered during processing of the »XJP* 
request! certain values may have already been altered by 
CPUMTR* These include: 

RA and RAX in the sub-control point exchange package* 
X5! Xtj! and X7 of the requesting program. 

XJP requests should always be issued with auto-recall when 
not using the central exchange instruction* 
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3»3«2 Constraints 

1- The sub-control point exchange package must be entirely 

contained within the field length of the executive program. 

2. The sub-control point RA is specified by the executive as 
relative to its own reference address. 

3. The sub-control point field length -CFL} must be entirely 
contained within the FL of the executive and must be 
greater than zero. 

M. No requests are honored by the operating system from sub¬ 
control points. Upon detection of such a request-i the 
executive program is restarted to process the request. 
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3.3.3 XCHNGE macro. 

The XCHNGE COMPASS macro is used to form an XJP RA+1 request 
and therefore initiate execution of a sub-control point. The 
macro definition resides in the common deck COMCMAC* 


Macro call format: 

XCHNGE addr-.time 
where: 

addr = address of sub-control point exchange package. 

time = CPU time limit in milli-seconds for sub-control 
point execution. 

XCHNGE forms the XJP request and calls the system - provided 
subroutine SYS= to enter the request. 
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3.4 Inter-Control Point Communication 

With this capability! certain programs may send blocks of data 
to cooperating sub-systems. 


3.4.1 


Definition of Receiving Buffers 

To enable receipt of such data blocks! a sub-system must set 
word ICAU in its control point area thusly: 



blO = length of receiving buffer 
baD = address of receiving buffer Q. 
bll = length of receiving buffer 1. 
bal = address of receiving buffer 1. 


As can be seen from the above format! a maximum of two separate 
buffers may be defined. Blocks of length 1 through the maximum 
length defined for the buffer -CblQ or bill may be transferred 
to each buffer. Any request to transfer more words than allowed 
is rejected. A buffer is considered full or busy if the first 
word is non-zero. Transfer requests are rejected if the buffer 
is full. 
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3.M.2 Inter-Control Point Data Transfer 
SIC Request 

Any program possessing a queue priority greater than MXPS 
or having user access bit "CSTP" set may request CPUMTR to 
transfer data to a specific sub-system. This request is 
in the form of the SIC RA+1 requests as follows: 



r = SOB if auto recall selected. 

buff = address of buffer to be transferred to sub-system, 
stat = address of status word in format: 


'N'- . - 

\^IT 






WORD 

ST 

Mfl 

30 

0 

STAT 

0 

bn 

sqp 

0 


bn = buffer number of sub-system to transfer to. 
sqp = destination sub-system queue priority. 

A block starting at buff will be transferred to the indicated 
subsystem. Block length is specified in bits 0-17 of the 
first word of the block -Cbuff}. Length includes this first 
word. This request is honored only from jobs with queue 
priority MXPS or those having access bit "CSTP** set. A 
request from any other Job is treated as a PP call. 
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3.M.S-5 Reply from CPUMTR in Response to SIC Request 



reply =1 if transfer completed successfully. 

3 if destination sub-system is not present 
in the system. 

S if sub-system buffer is fulln sub-system 

being movedn or sub-system job is advancing* 


7 if block length is specified in the first 
word is larger than that permitted by the 
sub-system. 


11 if destination buffer is undefined by sub¬ 
system. 

If auto-recall is selected and condition S above is presenti 
the calling program is placed in recall status until the 


condition ends. 


Ifn during processing of a transfer requesti it is found 
that the sub-system's buffer extends past its field lengthn 
the sub-system is aborted with error type SYET. 

3.M.3 Limitations 

No more than bM words may be transferred. 
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3>5 CIO Changes 

This effort revolves around! 1> attaining greater compatibility 
with SCOPE 3.M in the area of CIO interfaced 2> incorporation 
of mass storage error status return* Generallyn this involves! 

- merging the OPEN and CLOSE functions into CIO. 

- increasing CIOs use of end-of-recordi level 17 as 
a pseudonym for end-of-file. 

~ changing CIOs method of handling mass storage errors 
so as to provide status information to the user and 
to reduce the need for operator intervention. 

- updating several other programs for proper interface. 

In order to more centralize circular mass storage input/outputi 
the overlays SROi SlilOi and EPO will be removed from the system. 
Their functions will be performed by overlays local to CIO. 

Alsoi the programs OPE and CLO will be removed because CIO 
will perform all of their functions. Only those areas that 
involve visible changes to the KRONOS 2.0 CIO are documented 
below. 

3.5.1 File Environment Table -CFETJ 

3.5.1.1 Detail Error Status Field. 

If user error processing is in effect and after a mass 
storage error occursi certain information is returned to 
bits 0-11 of FET+L. See section on error processing. 
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3*5«1*2 Index Length Field* 

Random index area length is specified in bits lfl~3S of 
FET+7. 

3*5.2 Dayfile Error Messages* 

Most messages have been changed from previous versions of CIO* 

Those messages below that are marked with an asterisk are 
associated with a memory dump of the FET* All errors result 
in job abort* Below is a complete list of CIO error messages* 

In these messages-! fff represents the file name as given in 
the FET and nnn represents the FET address* 


"FET ADDRESS OUT OF RANGE AT nnn." 

FET extends past FL* 

* "BLOCK LENGTH ERROR ON FILE fff AT nnn." 

block length as specified during a "IdRITECId" operation 
is greater than SODB* 

* "BUFFER ARGUMENT ERROR ON fff AT nnn." 

A buffer pointer does not conform to these constraints! 
FIRST £ IN 
FIRST < OUT 
OUT < LIMIT < FL 

* "DEVICE ERROR ON FILE fff AT nnn." 

An unrecovered error occured on the mass storage 
device containing the file. 
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"I/O ON EXECUTE-ONLY FILE fff AT nnn." 

An attempt was made to readi write-i or position an 
execute-only file* "RETURN" is the only allowed 
function* 

"ILLEGAL FILE NAME fff AT nnn*" 

The file name contains a non-alphanumeric character* 

"I/O SEQUENCE ERROR ON FILE fff AT nnn*" 

Multiple concurrent functions were attempted on a 
single file* 

"ILLEGAL EXTENSION OF fff AT nnn." 

The function would result in lengthening of a file 
that has extend lock-out* 

"ILLEGAL MODIFICATION OF fff AT nnn*" 

EITHER: The function would result in shortening 

a modify-only file* -OR- 
The file has modify lock-out* 

* "ILLEGAL I/O REQUEST ON FILE fff AT nnn." 

The function code is unrecognized. 

"WRITE ON READ-ONLY FILE fff AT nnn." 

A write was attempted on a file with write lock-out* 

* "RANDOM ADDRESS NOT ON FILE fff AT nnn." 

The random address exceeds the number of addresses 
on the file* 
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* "REQUEST UNDEFINED ON DEVICE, fff AT nhn." 

The function cannot be performed on the device 
upon which the file resides. 

* "INDEX ADDRESS OUT OF RANGE FOR fff AT nnn." 

Random address return address is ^ FL. 

"n.T. NOT AVAILABLE ON FILE fff AT nnn." 

The magnetic tape executive is not executing. 

3 .S .3 Functions changed. 

3 .S. 3 .I READSKP. 

If the status and code fields in the FET contain 7M005X 
then, after the buffer is filled, CIO will skip to the next 
end~of~file instead of to end“of“record. Previous versions 
of ICRONOS only skipped to end~of“record. The macro format 
is! 

READSKP file,lev,recall. 

where! 

Lev is 17B if skip to EOF 

3 .S. 3.5 READEI. 

The function code for READEI is tOQ. This replaces the old 
500 code. 
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3»S.3»3 Forward skips- 

SKIPFn SKIPFFi and SKIPEI all operate via the 5M0 code. 
File skips are specified by placing 7MB in bits IM-l? of 
FET+0. Termination status as indicated below is always 
returned. 

Condition Status 


• 

EOR 

02X 

• 

EOF 

03X 

• 

EOI 

103X 

Backward skip 

s. 


SKIPS and SKIPFB both operate via the bMO code. File skips 
are specified by placing 7MB in bits lM-17 of FET+0. 


3 .S. 3 .S OPEN processing. 

The OPEN types REELi REELNRi and NR have been added to the 
macro. NR means *no rewind* and uses code 120. REEL -CBMOI 
and REELNR -CBOOl are intended for use with magnetic tape 
files. See the KRONOS 2-1 Tape ERS for details. If REEL 
or REELNR is used for a mass storage filei the function is 
treated as READ or READNR. If type is not specified in the 
macro*! ALTER is assumed for details on ALTER type. The 
macro forms a call to CI0=i Therefore*! the common deck 
COHCOPE will be removed. 
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The random index on a file that is to be OPENed is expected 
to be the last record before EOI. No EOFs may intervene* 

The random file bit in the FET fFET+l, bit M7> will be 
cleared during OPEN if one of the following conditions 
exist: 


- the last record before EOI is empty 
“ index area address is < S* 

If the index areas is too small to accommodate the entire 
index record*! the excess data is skipped* 

OPE may still be called in an RA**-! requests but OPE is 
changed to CIO by the system* 

3*5*3*b CLOSE processing* 

A CLOSE macro will be added as specified below: 

CLOSE file*! type-i recall 

where: 

file = address of FET for file* 
type » NR for no rewind 
UNLOAD for unload 
RETURN for return 
absent for rewind 

recall = present if auto recall desired 
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The 17M close function -CRETURNl is new and functions like 
UNLOAD for mass storage files* 

CLO may still be called in an RA+1 requestn but CLO is 
changed to CIO by the system. 

A random index is written at EOI only if the file is random-i 
has been written upon since the last OPEN and an index 
area is specified in the FET- 

A CLOSER macro will be added for closing magnetic tape 
reels. Macro formats 

CLOSER file,type^recall 

where s 

file = address FET for file 
type = NR for no rewind 
UNLOAD for unload 
absent for rewind 

See the KRONOS 5.1 magnetic tape ERS for details of operation. 

3.5.3.7 UNLOAD. 

UNLOAD is identical to REIilIND for mass storage files. 

3.5.3.fi Buffer pointers after position operation. 

Only REIilXND and UNLOAD cause IN and OUT to be set equal to 
FIRST. 
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3«5«M Functions added> 

3.5. M.1 RPHRLS - read PRUs with list. - code 530. 

This function operates in the same way as READLS except 
that each address in the list specifies a single PRU instead 
of a record {see p. 7-Mfl of KRONOS 5.0 Reference rianual 
Rev. C for explanation of READLSl. After the single PRU 
specified by each list entry is placed in the buffer-i the 
list position is advanced. 

Macro format - 

RPHRLS file-i recall 

where: 

file = FET address 

recall = if present-i auto-recall 

3.5. ‘4.5 READCIi) - read non-stop with control words - code 500. 

In this function each physical record is bounded by control 
words. This allows end-of-records and end-of-files to be 
read and detected without recalling CIO for the next 
sequential read. Reading normally terminates if the buffer 
becomes full or if EOI is detected. If the request is made 
with 7M in bits m-17 of FET+0-, reading will stop after 
detecting an EOF. 
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KRONOS 5.1 
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PRU formats 


SM 

M7 

3b 


23 

0 

/ / PRU 

SIZE 

/ 

/ 

/ BYTE COUNT 

/ 

/ ..* FIRST OF 

•CBYTE 

COUNTl/5 

DATA 

WORDS ..* 

/ 

/. 





/ 

/ EOR-EOF / 





/ 


PRU SIZE 

BYTE COUNT 

EOR-EOF 

READCIi) may not be used with unit record devices* 
Hacro format s 

REAOCU file*! lev<» recall 


Number of bO bit words in each 
PRU on device* 

Number of 12 bit data bytes in 
this PRU. 

If byte count is < SOOBi this is 
an end-of-record or end-of-file* 

If EOR-EOF is zero-i PRU is an end- 
of-recordi If 17Bi PRU is an end- 
of-file* 


where: 


file = FET address 

lev = termination level - 17B if stop at EOFn else 
zero or absent* 

recall if present indicates auto-recall desired* 
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3.S«M.3 URITECU - write non-stop with control words - code 

This function is the companion to READCU. PRUs are supplied 
to CIO in the format specified for READCU. It should be 
noted that data written using this method is stored in the 
device in the same format as if it had been written with 
any other write function. 

URITECU may not be used with unit record devices or line 
printers. 

Macro format: 

lilRITECli) file-i recall 

where: 

file = FET address 

recall - if »**, place URITECU code in FETi but do 
not recall CIO. 

- if present but not •**! select auto-recall 

3.S.M.M Magnetic tape functions. 

Three magnetic tape functions are recognized by CIO: 

READN -CSbQ} read *S* or *L* tape non-stop 
URITEN CSbm write *S* or *L* tape non-stop 
POSMF {110} position multi file set 
These functions may be used only for magnetic tape files. 

Macro formats: 

READN filen recall 
URITEN file-i recall 
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POSriF file-i recall 

where! 

file - FET address 

recall if present indicates auto-recall desired. 

See the KRONOS 5.1 Magnetic Tape ERS for details on use* 

3.S.S RETURN OF UNRECOVERABLE MASS STORAGE ERROR STATUS. 

Whenever a mass storage device returns an error status or the 
device driver detects an error-) an error status is placed in 
the status field of the FET. If the user error processing 
bit is set in the FET -CEP bit} and the FET length is greater 
than Si further "detail" status is returned to the useri if 
not seti a message is issued to the dayfile and the job is 
aborted. 

Error Status CSTATUS field} 

00M parity error. 

055 other error. 

Detail error status -Cbits 0-11 of FET+t} -Conly if 'EP* bit is set}: 
XODl parity error. 

XD05 address error. 

X003 device status error. 

XOOM til361 function reject. 

XOOS device reserved. 

XOOb device not ready. 

H007 track limit* idevice full} 
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After an error -Cwith *EP’ set>*i the file is positioned at the 
offending PRU. If the operation was a read and the system 
has verified that the proper PRU was read Calthough it probably 
contains bad dataln then above is 0 and the data is 

placed in the buffer and IN adjusted accordingly^ otherwise 
is M. If the file is randomi CRI is set as usual* 

3»S«L File status as kept in FSTi byte M. 

The file status is encoded as follows: 
bit 0 = 0 if file busy 

bit 1 = 1 if last operation was a write 

bits S-3 if last operation was read: 

0 = incomplete -Cbuffer full! 

1 = EOR encountered 

2 = EOF encountered 

3 = EOI encountered 

if last operation was position or write: 

0 = incomplete -Cbuffer exhausted-! no 
EOR/EOF> 

1 = complete 

bit b = 1 if file has been written upon* 

bit 7 = 1 if file has been written upon since it 

was last opened* 

bit fl « 1 if file has been opened 


ERS_ PAGE NO. 

KRONOS 2*1 __ 
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The previous function code is no longer held in the FST- 
This means that when using the STATUS macron those bits in 
the FSTn byte M -Cas explained above! will be returned to the 
FET instead of the previous function code as was returned 
in KRONOS 2-0. 

3«S«7 Miscellaneous CIO related changes 

3»S«7«1 Read common deck status return- 

All read common decks will returnn in Xli -S if EOI status 
was detected in the FET- 

3-S-7-S Provisions for flexibility in continuous writes- 

In order that continuous writes other than URITE may be 
maintained when using the write common decksi certain macros 
and the common decks will be altered as follows: 

- in the WRITE, REWRITE, WRITEN, and WRITECW 
macros, if the recall argument is *** then place 
the appropriate function code in the FET but do 

not call CIO, any other value specifies auto-recall- 

- if the symbol *WRIF$* is defined, the write common 
decks will re-issue the previous write code for a 
file when they determine that a write is required- 
If the symbol is not defined, a WRITE will be 
requested- 
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